Skip to content

Deploying from Git

Step-by-step guide to deploying applications from Git repositories in Sproobo

Deploy directly from your GitHub repository. Sproobo pulls your code onto your server, runs your build, and starts your app — no Dockerfile required for most site types.

⚠️

Git deployments require an active or trialing Sproobo subscription. Manual deploys and automatic webhook deploys are blocked when billing is inactive.

ℹ️

Sproobo supports Node.js, static, Docker Compose, and worker site types. A Dockerfile is only required for Docker-type sites.

Site Types and Requirements

Supported Site Types

  • Node.js: Any Node app. Sproobo runs your build commands and manages the process with PM2.
  • Static: Static exports (Next.js static, Vite, etc.). Build runs on the server, output is served by nginx.
  • Docker: Requires a docker-compose.yml in your repo. Sproobo runs docker compose up after each deploy.
  • Worker: Long-running background process (queue workers, cron jobs). Managed with PM2.

Creating a Site

  1. 1

    Navigate to Sites

    In your dashboard, click on "Sites" in the sidebar, then click "Create site".
  2. 2

    Connect GitHub

    If you haven't already, connect your GitHub account. Sproobo will request access to your repositories so it can pull your code during deployments.
  3. 3

    Select Repository and Branch

    Choose the repository and branch you want to deploy from. Sproobo will deploy from this branch each time you trigger a deployment.
  4. 4

    Choose Site Type

    Select the site type that matches your application:
    • Node.js — for server-side Node apps
    • Static — for static file exports
    • Docker — for Docker Compose apps
    • Worker — for background processes
    Sproobo will attempt to detect your project type automatically based on your repository contents.
  5. 5

    Configure Build Settings

    Set how your app is built and started:
    • Install command: e.g. npm install or pnpm install
    • Build command: e.g. npm run build
    • Start command: e.g. npm start (Node/Worker types)
    • Output directory: e.g. dist or out (Static type)
    • App port: The port your Node app listens on
  6. 6

    Choose Server and Domain

    Select which server to deploy to, then optionally set a custom domain. Sproobo will configure nginx and provision an SSL certificate automatically.
  7. 7

    Deploy

    Click "Deploy". Sproobo will:
    1. Clone your repository onto the server
    2. Run your install and build commands
    3. Start or restart your app
    4. Configure nginx and HTTPS

Subsequent Deployments

After the initial deploy, you can redeploy at any time from the site dashboard. Sproobo will:

  1. Pull the latest code from your configured branch
  2. Run the install and build commands again
  3. Restart the app with zero-downtime where possible
  4. Record the deployment in your deployment history

Environment Variables

Add environment variables before deploying so they are available at build and runtime. See Environment Variables →.

Deployment History

Every deployment is recorded with:

  • Timestamp and duration
  • Git commit hash
  • Build and deploy logs
  • Status (success / failed)

You can inspect logs for any past deployment and roll back to a previous version from the history view.

Next Steps