mirror of
https://github.com/dograh-hq/dograh.git
synced 2026-06-07 07:55:16 +02:00
66b085dde2
* docs: add windows commands for developer setup * feat: add windows scripts * fix(ui): make dev script cross-platform with cross-env * feat(scripts): enhance migration scripts for Alembic environment setup and add virtual environment activation
56 lines
1.2 KiB
Text
56 lines
1.2 KiB
Text
---
|
|
title: "Troubleshooting"
|
|
description: "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
|
|
lsof -i :3010
|
|
kill -9 $(lsof -t -i :3010)
|
|
```
|
|
```powershell Windows
|
|
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
|
|
docker stop $(docker ps -q)
|
|
```
|
|
|
|
**Step 2:** Disable restart policy for all containers
|
|
This prevents containers from automatically restarting:
|
|
```bash
|
|
docker update --restart=no $(docker ps -a -q)
|
|
```
|
|
|
|
**Step 3:** Verify
|
|
|
|
Check that no containers are running:
|
|
```bash
|
|
docker ps
|
|
```
|
|
|
|
Check restart policies (should show 'no' for each container):
|
|
```bash
|
|
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
|
|
docker compose down
|
|
|
|
docker compose down -v
|
|
```
|