Troubleshooting

Troubleshooting DHTI

Common issues and quick fixes for running the DHTI stack.

Ports & Networking

• Port already in use: Check with lsof -i :<port> and stop conflicting processes.
• Cannot access OpenMRS or LangServe: Ensure containers are running (docker ps).
• Ollama model not found: Enter the container and pull the model: docker exec -it dhti-ollama-1 ollama pull <model>

Container Health

• Container keeps restarting: Run docker logs <container> for error details (missing env, bad config, etc.).
• Elixir not updating after dev sync: Ensure no dependency changes; otherwise, rebuild the image.
• Conch UI not updating: Clear browser cache or restart the frontend container.

Compose Issues

• docker-compose.yml not found: Run npx dhti-cli compose add -m <modules> to generate.
• Service fails to start: Check for missing images, bad config, or port conflicts.
• Environment variables: Ensure .env is present and up to date if required.

General Tips

• Use npx dhti-cli help for command reference.
• Use docker ps and docker logs <container> for diagnostics.
• For persistent issues, try npx dhti-cli docker -d to stop and remove all containers, then -u to restart.