Frequently Asked Questions

Quick answers to the most common questions about TurboV.

General Questions

What is TurboV?

TurboV is a self-hosted platform that helps you deploy and manage applications on your own servers. It's like having your own personal Heroku or Vercel, but running on infrastructure you control.

Is TurboV free?

TurboV is open source and free to use. You only pay for your own servers and infrastructure. There are no licensing fees or per-user charges.

What programming languages are supported?

TurboV supports any language that can run in a Docker container. This includes Node.js, Python, Go, Ruby, PHP, Java, Rust, and more. For web applications, we can auto-detect and configure builds for most popular frameworks.

Do I need to know Docker?

No! TurboV can automatically detect your application type and generate a Dockerfile for you. However, if you want full control, you can provide your own Dockerfile.

Can I use TurboV for production applications?

Yes! TurboV is designed for production workloads. It includes automatic SSL certificates, health monitoring, automatic restarts, and zero-downtime deployments.

Getting Started

What do I need to get started?

You need: 1) A GitHub account, 2) A Linux server (VPS) with at least 1GB RAM, 3) A domain name (optional but recommended). That's it!

How do I install TurboV?

TurboV consists of three components: the backend (API server), the dashboard (web UI), and the agent (runs on your servers). Follow our Installation Guide for step-by-step instructions.

Can I try TurboV without a server?

Currently, you need your own server to run applications. However, you can start with a small $5/month VPS from providers like DigitalOcean or Hetzner.

How long does deployment take?

Most deployments complete in 1-5 minutes, depending on your application size and build complexity. The first deployment may take longer as dependencies are downloaded.

Servers & Agents

How many servers can I connect?

There's no limit to the number of servers you can connect to a single TurboV instance. Add as many as you need for your workload.

What operating systems are supported?

TurboV works on most Linux distributions. We recommend Ubuntu 20.04 or newer for the best experience. The agent requires Docker to be installed.

Does the agent auto-update?

Yes, by default the agent automatically updates when new versions are available. You can control this behavior in server settings or disable auto-updates entirely.

Can I run the agent without root access?

The agent needs Docker access, which typically requires root or membership in the docker group. For security, we recommend running the agent as a dedicated user with docker group access.

What happens if the server goes offline?

If a server goes offline, the dashboard will show it as 'Offline'. Your applications will stop running, but they'll automatically restart when the server comes back online. TurboV will queue any pending deployments.

Deployments

How do automatic deployments work?

When you push code to your configured branch, GitHub sends a webhook to TurboV, which automatically starts a new deployment. This requires the GitHub App to be installed on your repository.

Can I deploy without a Dockerfile?

Yes! TurboV can auto-detect your application type and generate an appropriate Dockerfile. This works for most Node.js, Python, Go, and static site applications.

How do I roll back to a previous deployment?

Go to your application's Deployments tab, find the previous successful deployment, and click 'Rollback'. This will redeploy that version.

Can I run multiple applications on one server?

Yes! You can deploy multiple applications to a single server. Each application runs in its own container and can have its own domain.

What happens to my old deployments?

TurboV keeps a configurable number of deployment artifacts. Older deployments are cleaned up automatically to save disk space. You can adjust retention settings in server configuration.

Domains & SSL

How do I add a custom domain?

Go to your application's Settings → Domains, add your domain, then configure DNS records as shown. TurboV will automatically provision an SSL certificate.

Are SSL certificates free?

Yes! TurboV uses Let's Encrypt to provide free SSL certificates for all your domains. Certificates are automatically renewed before expiration.

Can I use multiple domains for one application?

Yes, you can add multiple domains to a single application. Set one as the primary domain, and all others will redirect to it.

How long does DNS propagation take?

DNS changes can take anywhere from a few minutes to 48 hours to propagate globally. Most changes are visible within 1-2 hours.

Security

Is my code secure?

Your code is only accessed during deployments. TurboV uses GitHub's secure API with scoped tokens. Your code is never stored permanently on our servers.

How are environment variables stored?

Environment variables are stored encrypted in the database and only decrypted when needed for deployments. They're never exposed in logs or the API.

Can I limit who can access my TurboV instance?

Yes. TurboV uses GitHub OAuth for authentication. Only users with access to your GitHub organization or team can log in, depending on your configuration.

What ports does TurboV use?

The agent needs outbound HTTPS (443) to communicate with the backend. For applications, ports 80 and 443 should be open for incoming traffic. The agent itself doesn't listen on any public ports.