Troubleshooting

Common issues you might encounter and how to fix them.

​

Deployment Issues

​

Build Failed

Symptoms: Deployment stops during the build phase with an error. Solutions:

1. Check your Dockerfile
   • Ensure your Dockerfile exists in the repository root
   • Verify the Dockerfile syntax is correct
   • Check that all required files are present
2. Verify build path
   • If Dockerfile is in a subdirectory, set the Build Base Path correctly
   • Update Dockerfile Path if needed
3. Check build logs
   • View the deployment logs for specific error messages
   • Look for missing dependencies or build errors

​

Application Won’t Start

Symptoms: Build succeeds but application doesn’t start. Solutions:

1. Check the port
   • Verify your application listens on the port you configured
   • Default is port 3000, but you can change it in settings
2. Review environment variables
   • Ensure all required variables are set
   • Check for typos in variable names
   • Verify values are correct
3. Check application logs
   • View logs in the Logs tab
   • Look for startup errors or missing dependencies

​

GitHub Integration Issues

​

Repositories Not Showing

Solutions:

1. Reconnect GitHub
   • Go to Settings > Connectors
   • Disconnect and reconnect your GitHub account
   • Make sure you authorize the correct repositories
2. Check repository access
   • Verify you have access to the repositories
   • Check if repositories are archived or private

​

Webhooks Not Working

Solutions:

1. Verify webhook configuration
   • Check GitHub repository settings > Webhooks
   • Ensure Nixopus webhook is active
2. Check branch settings
   • Verify your project is configured for the correct branch
   • Make sure you’re pushing to the right branch

​

Authentication Issues

​

Can’t Log In

Solutions:

1. Check your email
   • Look in spam/junk folder
   • Verify email address is correct
   • Wait a few minutes for delivery
2. Request new code
   • Click “Change email” to get a new code
   • Codes expire after a few minutes

​

API Key Not Working

Solutions:

1. Verify the key
   • Copy the entire API key (no spaces)
   • Check for typos
2. Check key status
   • Go to Settings > API Keys
   • Verify the key hasn’t been deleted
   • Check if it has expired

​

Getting Help

If you’re still stuck:

1. Check the logs
   • Deployment logs show detailed errors
   • Application logs reveal runtime issues
2. Review documentation
   • Search for your specific issue
   • Check relevant guides
3. Contact support
   • Include error messages
   • Share relevant logs
   • Describe what you were trying to do