Quick Start Guide

Deploy your first application on your own server in under 5 minutes.

1. Connect Your Server

TurboV connects to any clean Linux server (Ubuntu 20.04+, Debian 11+) over an outbound secure WebSocket channel. You do not need to share SSH private keys with TurboV.

  1. In the TurboV dashboard, navigate to Servers → Add Server.
  2. Give your server a name (e.g. prod-eu-1), select your cloud provider, and click Next.
  3. Copy the personalized installation command displayed in the modal:
curl -sSL https://install.turbov.io | bash -s -- --token YOUR_SERVER_TOKEN
  1. SSH into your server terminal as root (or run with sudo) and execute the command.
What Happens Next?

The installation script installs the TurboV Agent daemon, registers a systemd service, verifies Docker compatibility, provisions the Traefik v3 reverse proxy on the turbov bridge network, and sets up swap space automatically if your server has 1GB–2GB RAM. Within seconds, the dashboard reflects the server status as ONLINE.

2. Connect Your GitHub Repository

TurboV integrates directly with GitHub using a granular GitHub App:

  1. In the dashboard, click Add App (or go to Projects → Add Application).
  2. Click Connect GitHub. Select which GitHub organization or personal repositories TurboV can access.
  3. Select your repository from the dropdown list.
  4. Choose the default branch to deploy (e.g. main or production).
Monorepos Supported

If your project lives in a subdirectory of a monorepo, specify the Root Directory (for example apps/web or packages/api).

3. Configure Environment Variables & Domain

Before triggering your initial build, configure any required configuration and routing:

  1. Environment Variables: Add your .env variables or click Bulk Import to paste your .env file directly. All secrets are immediately encrypted at rest using AES-256-GCM envelope encryption.
  2. Custom Domain: Enter the domain you wish to assign to the application (e.g. app.yourdomain.com).
  3. Point your DNS A or CNAME record to the public IP address of your server.

4. Trigger Deployment

Click Deploy Application:

[Build Pipeline]
1. Clone:   Cloning commit 8f4b1a2 from branch 'main'...
2. Detect:  Detected Next.js framework (Node.js runtime).
3. Build:   Building container image 'turbov-app-web:8f4b1a2'...
4. Start:   Starting container on internal bridge network 'turbov'...
5. Verify:  Healthcheck passed (HTTP 200 on port 3000).
6. Route:   Traefik dynamic route registered for 'app.yourdomain.com'.
7. TLS:     Let's Encrypt certificate generated successfully.
Status: LIVE

Your application is now running securely behind Traefik with automatic SSL, live log streaming, and continuous monitoring.

Next Steps