Docker Issues

Troubleshooting Docker deployment problems.

Container Issues

Container Not Starting

Check:

1. Docker logs: docker compose logs app
2. Environment variables
3. Volume mounts
4. Port conflicts

Solutions:

1. Check logs for specific errors
2. Verify .env file exists and is correct
3. Check bucket configuration, credentials, and network access from the app container
4. Verify ports are available

Health Check Failing

Check:

docker inspect --format='{{.State.Health.Status}}' tma-cloud-app

Solutions:

1. Check application logs
2. Verify database connection
3. Check Redis connection (if enabled)
4. Review health check configuration

Network Issues

Cannot Access Application

Check:

1. Container is running: docker compose ps
2. Port mapping is correct
3. Firewall rules
4. Container logs

Solutions:

1. Verify port mapping: docker compose ps
2. Check BPORT in .env
3. Access via http://localhost:3000 (or configured port)

Related Topics

• Docker Compose / Docker - Docker Compose and prebuilt images
• Environment Setup - Configuration