> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dograh.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common issues and solutions for running Dograh AI

# Troubleshooting

## Freeing Up Ports

### When a port is already in use:

##### Check what's using the port first and then kill the process (may require sudo on Linux)

<CodeGroup>
  ```bash macOS/Linux theme={null}
  lsof -i :3010
  kill -9 $(lsof -t -i :3010)
  ```

  ```powershell Windows theme={null}
  netstat -ano | findstr :3010
  # Find the PID in the last column, then:
  Stop-Process -Id <PID> -Force
  ```
</CodeGroup>

### When Docker containers are using the ports (with auto-restart enabled):

**Step 1:** Stop all running containers

```bash theme={null}
docker stop $(docker ps -q)
```

**Step 2:** Disable restart policy for all containers
This prevents containers from automatically restarting:

```bash theme={null}
docker update --restart=no $(docker ps -a -q)
```

**Step 3:** Verify

Check that no containers are running:

```bash theme={null}
docker ps
```

Check restart policies (should show 'no' for each container):

```bash theme={null}
docker inspect -f '{{.Name}} - {{.HostConfig.RestartPolicy.Name}}' $(docker ps -a -q)
```

## Stopping Dograh Services

##### Stop services or Stop and remove all data (full cleanup)

```bash theme={null}
docker compose down

docker compose down -v
```
