Deploy a GitHub Repository

The Custom app option builds and runs code from a GitHub repository on your Cloud Workspace.

Deploy

1. Go to Deploy and choose Custom app.
2. Enter your repository. The branch is detected automatically; change it if you need another.
3. If your app needs a database (MySQL, MariaDB, PostgreSQL, MongoDB or Redis), pick it in the Database section. It is created with the app and its variables are set for you. See Add a Database to Your App.
4. Open Advanced build options only if you need them. FlyNode builds with Nixpacks, which detects most Node, Next.js, Laravel, Python and Go projects on its own. You can choose Use my Dockerfile instead, set the port your app listens on (3000 when empty), give the folder of your app inside a monorepo, and set the install, build and start commands. The start command takes plain words only (no &&, ; or |). To run several steps, put them in a script of your project and run that.
5. Keep the generated domain or enter your own.
6. Review and deploy.

Or deploy with Claude or the command line

1. Connect once with Deploy and Migrate with Claude or the CLI.
2. Tell Claude: Deploy https://github.com/you/your-repo to FlyNode. Or run flynode deploy in your project folder.
3. Add --db postgresql (or mysql, mariadb, mongodb, redis) to create a database at the same time.
4. Watch it with flynode status.

After deploying

• Logs show the most recent output of your app.
• Redeploy rebuilds from the latest commit on your branch.
• Restart restarts the running container without rebuilding.

Private repositories

Choose Private repository in the wizard to deploy from a private GitHub, GitLab or Bitbucket repository. See Deploy a Private Repository.

Resources

Apps share the RAM, CPU and storage pool of your Cloud plan rather than having individual limits. See Understanding Resource Allocation.