DocsOverviewQuick StartFrameworksDeploymentsDomainsEnv VarsFeature FlagsAI GatewayAPI ReferenceWebhooks

Quick Start

Deploy your first app

Go from a Git repository to a live URL in under 5 minutes. No credit card required to get started.

Estimated time: ~3 minutes

Before you begin

A GitHub account with at least one repository
A Deploxa account (sign up free at deploxa.com)
Your project must have a supported framework or a Dockerfile

Steps

1

Connect your GitHub account

Sign in to Deploxa and navigate to Settings → Integrations. Click Connect GitHub and authorize the Deploxa GitHub App. You can grant access to all repositories or select specific ones.

GitHub App authorization

Deploxa requests read access to code and write access to deployment statuses.

2

Create a new project

From your dashboard, click New Project. Select your organization, then choose the repository you want to deploy.

Repositorymy-org/my-app
FrameworkAuto-detected: Next.js
Branchmain
Build commandnext build
Output directory.next

Deploxa auto-detects your framework and pre-fills the build configuration. You can override any value before clicking Deploy.

3

Add environment variables (optional)

If your app needs environment variables, add them in the Environment Variables section before the first deploy. They are encrypted with AES-256-GCM before storage.

DATABASE_URL=postgresql://user:pass@host/db NEXT_PUBLIC_API_URL=https://api.example.com SECRET_KEY=your-secret-here

Variables prefixed with NEXT_PUBLIC_ are exposed to the browser. All others remain server-side only. See the Env Vars guide for targets and bulk import.

4

Deploy

Click Deploy. Deploxa queues a build, clones your repo, runs your build command, and uploads the output. You can watch the live build log stream in real-time.

▶ Cloning repository…

▶ Detecting framework: Next.js 15

▶ Installing dependencies (pnpm install)…

▶ Running build (next build)…

▶ Uploading build artifacts to S3…

✓ Deployment ready in 47s

5

Go live

Once the deployment status is Ready, your app is live on a Deploxa subdomain:

my-app-abc123.deploxa.app

Want a custom domain? Add it in 2 minutes →

Auto-deploy on push

Every push to your production branch triggers a new deployment automatically. Every pull request gets its own preview URL that updates with each commit.

Production branch

Push to main → production deployment. Configurable to any branch.

Preview deployments

Pull requests get isolated preview URLs. Each commit updates the preview.

Next steps

Add a custom domain

Point your domain to Deploxa.

Environment variables

Manage secrets and config.

Understand deployments

Rollbacks, statuses, logs.

Framework guides

Next.js, Python, Docker + more.