How to deploy a web app from GitHub on Voroa

This guide walks you through deploying a web app from a GitHub repository to Voroa, from connecting your account to your first live URL.

Before you start

• A GitHub account with the repository you want to deploy.
• An app that listens on the port from process.env.PORT (Voroa sets this automatically).

Step 1 — Connect GitHub

From the dashboard, select Connect GitHub and install Voroa on the repositories you want to deploy. You can choose all repositories or only specific ones. Your code and access stay private.

Step 2 — Create a service

Select New service, then pick the repository and branch to deploy. Give the service a name. Voroa uses this branch as the source of truth for builds.

Step 3 — Configure the build (optional)

Voroa builds most apps automatically. If your app needs a custom build or start command, you can set them now or later from Settings. See build and start commands.

Step 4 — Deploy

Select Deploy. Voroa builds your app and streams the logs. When the build finishes, your service gets a live URL you can open right away.

What happens next

With auto-deploy on, every push to your branch ships a new build automatically. See how to enable auto-deploy.

Deploy your stack

Follow the guide for your framework — each covers the build, the start command, and going live:

• Deploy a Node.js app
• Deploy a Next.js app
• Deploy a React (Vite) app
• Deploy a Python Django app
• Deploy a static site