Fix common VPS and Docker deployment problems
Troubleshooting guides for build failures, HTTPS issues, ports, webhooks, private repositories, databases, and Docker resources.
20 pages
Troubleshooting
How to fix Docker app will not start
Troubleshoot Docker app will not start by checking check logs, start commands, env vars, and container ports in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix PORT environment variable issues
Troubleshoot PORT environment variable issues by checking make the app listen on the platform-provided PORT value in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix Let's Encrypt certificate failed
Troubleshoot Let's Encrypt certificate failed by checking verify DNS, ports, and domain routing before retrying in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix GitHub webhook not working
Troubleshoot GitHub webhook not working by checking confirm webhook URL, branch, delivery status, and secret validation in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix private repository clone failed
Troubleshoot private repository clone failed by checking check token permissions and saved Git credentials in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix Docker container out of memory
Troubleshoot Docker container out of memory by checking inspect resource usage and tune app limits or server size in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix VPS disk full from Docker
Troubleshoot VPS disk full from Docker by checking prune old images, review logs, and move persistent data carefully in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix Next.js deployment failed
Troubleshoot Next.js deployment failed by checking review build command, Node version, and start command in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix Postgres connection refused
Troubleshoot Postgres connection refused by checking check database container status and injected connection variables in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix Caddy domain routing problems
Troubleshoot Caddy domain routing problems by checking verify Caddy config, app health, DNS, and ports in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix Nixpacks build failed
Troubleshoot Nixpacks build failed by checking inspect framework detection, lockfiles, and build scripts in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix app health check failed
Troubleshoot app health check failed by checking confirm the app responds after startup before traffic switches in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix Redis connection failed
Troubleshoot Redis connection failed by checking check service status, network, and environment variables in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix MySQL connection failed
Troubleshoot MySQL connection failed by checking verify credentials, host values, and database readiness in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix custom domain not resolving
Troubleshoot custom domain not resolving by checking confirm DNS records point to the server IP in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix deployment rollback needed
Troubleshoot deployment rollback needed by checking use deployment history to restore the last working release in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix logs not streaming
Troubleshoot logs not streaming by checking check app status, websocket access, and dashboard API reachability in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix admin token lost
Troubleshoot admin token lost by checking reprint the token on the server and store it securely in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix dashboard cannot reach API
Troubleshoot dashboard cannot reach API by checking check API URL, CORS origin, proxy settings, and network access in a Docker, VPS, or Better-PaaS deployment workflow.
Troubleshooting
How to fix scheduled job not running
Troubleshoot scheduled job not running by checking verify cron expression, app container state, and command path in a Docker, VPS, or Better-PaaS deployment workflow.