Last updated on 9th February 2026

Common Deployment Errors

Connection Errors

If DeployHQ can't connect to your server, check your server credentials, firewall rules, and that your server is accessible from the internet.

Permission Errors

Make sure the user account DeployHQ uses has write permissions to the deployment directory.

Timeout Errors

Large deployments may time out. Consider using the "changed files only" option to reduce the number of files transferred.

Build Failures

Check the build log for error messages. Common causes include missing dependencies, incompatible versions, and syntax errors.

Files Uploading Unexpectedly

If files are being uploaded that shouldn't be, check your .deployhqignore file and make sure it's properly configured.