Getting Started with Kovra Cloud

What is Kovra Cloud?

Kovra Cloud is a fully managed Platform-as-a-Service (PaaS) tier within the Kovra IDP. It lets you deploy applications and provision managed databases without managing any infrastructure yourself. No Kubernetes knowledge required — just push code and Kovra Cloud handles the rest.

Key features:

• Deploy apps from Git repositories or pre-built templates
• Managed PostgreSQL databases via CloudNativePG (CNPG)
• Automatic TLS certificates and custom domain support
• WireGuard VPN for private access (Business and Enterprise Cloud plans)
• Usage-based billing with predictable flat-rate base pricing
• Built-in monitoring, logging, and alerting

How Kovra Cloud Differs from BYOC

Signing Up

1. Create a Kovra account at app.kovra.dev  using email and password.
2. Create or join an organization. Each organization gets its own isolated tenant namespace.
3. The Kovra Cloud feature must be enabled for your organization.

Picking a Plan

Kovra Cloud offers four plans. All plans include unlimited team members — pricing is based on infrastructure consumed, not seat count.

See Billing & Usage for detailed plan information.

Deploying Your First App

Prerequisites

• An active Kovra Cloud tenant (provisioned automatically when you pick a plan)
• A GitHub or GitLab integration connected (Settings > Integrations)

Step 1: Create a Tenant

When you first select a Kovra Cloud plan, a tenant is automatically provisioned for your organization. The tenant creates an isolated namespace in the format kovra-{first-8-chars-of-org-uuid}.

Step 2: Create an Application

Navigate to Apps in the dashboard and click Create Application. You have two options:

From Template:

1. Select a pre-built template (Go, Java, Next.js, or Fullstack)
2. Pick your connected GitHub/GitLab integration
3. Enter a name and description
4. Kovra Cloud automatically creates a Git repository and deploys the app

From Git Repository:

1. Select an existing repository from your connected integrations
2. Enter a name and description
3. Kovra Cloud deploys from your repository

Step 3: Wait for Deployment

The application goes through these stages:

1. pending — Application record created
2. provisioning — Helm chart being deployed to your tenant namespace
3. ready — Application is live and accessible

Step 4: Access Your App

Once deployed, your app is accessible at a generated URL. You can also configure a custom domain (see App Deployment Guide).

Understanding Your Dashboard

When your organization uses Kovra Cloud, the dashboard shows an app-centric view:

Apps

View, create, and manage your deployed applications. See deployment status, logs, and resource usage.

Databases

Create and manage PostgreSQL databases. View connection strings and monitor database health.

VPN (Business and Enterprise Cloud)

Enable WireGuard VPN for private access to your databases and internal services. Download configuration files for your devices.

Usage

Monitor your current resource consumption against your plan limits. View vCPU, RAM, storage, and database usage.

Organization States

The dashboard adapts to your organization’s setup:

1. Empty organization — Shows a “Deploy your first app in 2 minutes” landing page with a call-to-action.
2. Kovra Cloud only — Shows the app-centric dashboard described above (Apps, Databases, VPN, Usage).
3. BYOC only — Shows the standard cluster-centric dashboard with a Kovra Cloud promotional banner.
4. Mixed (Kovra Cloud + BYOC) — Shows both sections. When creating an app, a “Where to deploy?” step lets you choose between Kovra Cloud and your own clusters.

Next Steps

• App Deployment Guide — Deep dive into deploying and configuring applications
• Managed Databases — Create and manage PostgreSQL databases
• VPN / Private Access — Set up WireGuard VPN (Business+ plans)
• Billing & Usage — Understand your plan and resource usage