Skip to main content
Deployment

VoltOps Deploy

VoltOps Deploy

VoltOps Deploy is a managed deployment platform built specifically for VoltAgent applications. Connect your GitHub repository and deploy your AI agents with zero configuration, automatic SSL certificates, and custom domain support.

Features

  • GitHub Integration - Connect public or private repositories via the VoltOps GitHub App
  • Automatic Deployments - Push-to-deploy with webhook triggers on every commit
  • Environment Variables - Build-time and runtime env var management with secrets support
  • Custom Domains - CNAME-based custom domain support with automatic SSL provisioning
  • Real-time Logs - Monitor build progress and application logs in real-time
  • HTTP Basic Auth - Password-protect your deployments (Pro plan)
  • Agent Discovery - View registered agents and workflows directly from the deployment dashboard

Getting Started

1. Navigate to Deploy

Go to console.voltagent.dev/deployments and click New deployment.

2. Connect Your Repository

Choose how to connect your repository:

  • Public GitHub - Enter the repository URL directly (e.g., https://github.com/user/repo)
  • GitHub App - Install the VoltOps GitHub App for private repository access

3. Configure Build Settings

Select the branch to deploy and configure build options:

  • Branch - Choose the branch to deploy (defaults to main)
  • Auto-deploy - Enable to automatically deploy on every push

4. Set Environment Variables

Add any environment variables your application needs:

  • Runtime variables - Available to your running application
  • Build-time variables - Available during the build process
  • Secrets - Encrypted values hidden from logs and UI
Bulk Import

Paste a .env file content directly into the key field to import multiple variables at once.

5. Deploy

Click Deploy to start the build process. You can monitor the build logs in real-time.

Configuration Options

Branch Settings

Configure which branch to deploy and how deployments are triggered:

SettingDescription
BranchThe Git branch to deploy
Auto-deployAutomatically deploy on push to the selected branch

Environment Variables

Environment variables support multiple configurations:

OptionDescription
SecretEncrypts the value and hides it from logs
RuntimeMakes the variable available to the running application
Build-timeMakes the variable available during build

Custom Domains

Add a custom domain to your deployment:

  1. Go to the Domains tab in your deployment details
  2. Click Add Domain and enter your domain
  3. Create a CNAME record pointing to the provided target
  4. SSL certificate is provisioned automatically once DNS propagates

HTTP Basic Authentication

Protect your deployment with username and password authentication (Pro plan only):

  1. Go to the Security tab
  2. Enable HTTP Basic Auth
  3. Enter username and password
  4. Save to trigger a redeployment

Pricing

VoltOps Deploy is available on Core and Pro plans.

FeatureFreeCore ($50/mo)Pro (Custom)
Deployments-IncludedIncluded
Parallel Builds012
Runtime Minutes043,200/mo (1 agent)129,600/mo (3 agents)
Build Minutes0100/mo300/mo
HTTP Basic Auth--Yes
Team Members1320
Runtime Minutes Explained

Runtime minutes are calculated per active deployment. Core plan includes enough minutes for 1 agent running 24/7 for a month (30 days × 24 hours × 60 min = 43,200 min). Pro plan covers 3 agents running continuously (129,600 min).

Usage-Based Billing

  • Build minutes: Included minutes used first; extra usage billed at $0.10 per 10 minutes
  • Runtime minutes: Metered per active deployment minute; extra usage billed at ~$0.005/min
  • Queued builds: When parallel build limit is reached, builds queue automatically and start when a slot becomes available

FAQ

Which repositories can I deploy?

You can deploy public GitHub repositories using a direct URL, or private repositories by installing the VoltOps GitHub App.

How do automatic deployments work?

When auto-deploy is enabled, VoltOps receives webhook events from GitHub. Each push to the selected branch triggers a new deployment automatically.

How do I add a custom domain?

Navigate to the Domains tab in your deployment details, enter your domain, and create a CNAME record pointing to the provided target. SSL certificates are provisioned automatically.

What happens when I hit the parallel build limit?

Builds queue automatically and start as soon as a build slot becomes available. You can see queued builds in the deployment dashboard.

How do I manage secrets?

Mark environment variables as Secret to encrypt their values. Secret values are hidden in the UI and logs but available to your application at runtime.

Can I password-protect my deployment?

Yes, HTTP Basic Authentication is available on Pro plans. Enable it in the Security tab of your deployment settings.

How do I view application logs?

Use the Logs tab in the deployment detail page for real-time application logs. Build logs are available in the Deployments tab.

What build systems are supported?

VoltOps Deploy supports Dockerfile and Nixpacks for building your application. The build system is auto-detected based on your repository contents.

How do I cancel a running deployment?

Click the Cancel button next to the active deployment in the Deployments list. The build will be stopped and marked as cancelled.

Can I rollback to a previous deployment?

Currently, you can redeploy from a specific commit by updating your branch settings. Full rollback support is coming soon.

Table of Contents