# Truebleshooting

### 1. Node Not Starting

**Symptom**: Container exits immediately or logs show errors.

**Checks**:

* **Private Key**: Ensure `PRIVATE_KEY` starts with `0x`.
* **Ports**: Check if port `8000` (or your configured port) is already in use.
* **Database**: Ensure Typesense or the database container is running.

**View Logs (Docker)**:

```bash
docker logs ocean-node
```

**View Logs (PM2)**:

```bash
pm2 logs ocean-node
```

### 2. "Database Retrieve Error"

If you see errors related to retrieving data from the database:

* Ensure the database container (`typesense` or `elasticsearch`) is healthy.
* Check network connectivity between the Node container and the Database container.

### 3. GPU Not Detected

If your node is not picking up your GPU for compute jobs:

* Ensure you have the correct drivers installed (NVIDIA drivers, CUDA).
* If running in Docker, ensure you have the **NVIDIA Container Toolkit** installed so Docker can access the GPU.
* Check `DOCKER_COMPUTE_ENVIRONMENTS` in your config to see if it was manually overridden.

### 4. Rate Limits

If you see errors related to Docker Hub rate limits:

* This happens when pulling too many images.
* **Solution**: Authenticate with Docker Hub (`docker login`) or upgrade your Docker Hub plan.

### Where to Get Help

* **Discord**: Join the Ocean Protocol Discord `dev-support` channel.
* **GitHub**: Open an issue in the [ocean-node repository](https://github.com/oceanprotocol/ocean-node/issues).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.oncompute.ai/ocean-node/truebleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
