Docs
Get Started

Getting started

New trial users follow a three-step onboarding flow:

  1. Complete a profile and required verification.
  2. Select a repository or open-source template.
  3. Watch the Kuberns AI agent prepare and deploy the application.

The dashboard currently presents a 7-day free trial with no card required. Users who are not in the trial onboarding state go directly to the dashboard.

Before you begin

Prepare:

  • A Kuberns account.
  • A GitHub repository, or a template from the marketplace.
  • Required application secrets and external-service credentials.
  • The branch you want to deploy.

Signing in

Kuberns is passwordless. Sign in with Google or GitHub.

  1. Open the Kuberns dashboard.
  2. Choose Google or GitHub.
  3. Complete the provider authorization.

Step 1: Complete your profile

Onboarding step 1: the profile form asking for your name, what best describes you (Freelancer, Professional, or Student), what you plan to deploy, and a phone number with a Get OTP button

Provide:

  • Your name.
  • Your role.
  • What you plan to deploy.
  • Acceptance of the terms and conditions.
  • Phone and OTP verification when required for your region.

Step 2: Select a deployment source

Onboarding step 2: choosing a deployment type between Connect Custom Repository and Use Open source Templates

Choose a repository or a template. Available regions and template options are loaded from Kuberns at runtime.

Deploy a repository

  1. Choose GitHub.
  2. Install or select the Kuberns GitHub App, and authorize repository access.
  3. Select the installation, repository, and branch.
  4. Select an available region.
  5. Start deployment.

The Connect Your Repository form: GitHub organization, repository, and branch selectors, service name and hosting region, the pricing plan, and an Add Env Vars control above the Deploy with Agent button

Deploy an open-source template

  1. Choose Open-source template.
  2. Select a template.
  3. Enter the values requested by its configuration.
  4. Select the resource and region options shown by the dashboard.
  5. Deploy.

Templates can use predefined container configuration, managed resources, and environment-variable requirements. Templates marked for CI/CD can use a forked repository so later source changes can participate in the deployment workflow.

Step 3: Let the agent deploy

Kuberns creates the initial project, service, and environment, then starts a temporary AI agent. The page polls agent state and shows the live agent view after the session is running.

The agent can detect the framework, root directory, dependency files, ports, build commands, process commands, Dockerfiles, environment-variable names, and supporting resources.

When analysis completes, Kuberns synchronizes the detected configuration, terminates the temporary agent host, and starts the standard build and deployment flow.

Read AI agent lifecycle for status and failure behavior.

After deployment

Deployment success screen: an "Agent mission complete" badge with the total deploy time, and a Deployment Successful card showing the build number, repository, branch, commit, and a Go to Dashboard button

Open the service environment to:

  • Check build and service logs.
  • Add or update environment variables.
  • Review detected deployment settings.
  • Inspect resources and metrics.
  • Configure a domain after the account is eligible.