Troubleshooting

Deploy Failed: SSH Connection Refused

Your server is not accepting SSH connections on port 22. Check:

• The server is online (ping the IP)
• Port 22 is open in your firewall / security group rules
• The SSH username is correct

Deploy Failed: Permission Denied

The deploy user does not have write access to the working directory. Run on your server:

sudo chown -R deployship:deployship /var/www/your-project

Deploy Succeeded but Domain Returns 502

Your application is not listening on its assigned port. Check:

1. The deploy log for a port warning — DeployShip shows a warning if nothing is listening on the expected port
2. PM2 logs: pm2 logs your-project-name
3. That your application reads PORT from the environment variable

Nothing Is Listening on Port X

Your app is likely binding to a hardcoded port. Update your application:

// Node.js — read from environment
const port = process.env.PORT || 3000;

# Python — read from environment
port = int(os.environ.get('PORT', 8000))

pm2 logs show "Missing script: start"

Your package.json does not have a start script. Either:

• Add "start": "node server.js" to your package.json scripts
• Update the Start Command in Project Settings to point directly to your entry file (e.g. node dist/main.js)

---