Skip to main content

Documentation Index

Fetch the complete documentation index at: https://akua-1dce587a.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

April 2026
PlatformAPICustomization

Per-installation git repositories

Every installation now gets its own private git repository. Clone it, edit the inputs or composition, push, and Akua rolls out the change. The repository is the same source of truth the dashboard reads from. UI edits and git pushes converge on the same state.Use the new repository to:
  • Patch any field on any rendered resource without forking the upstream package.
  • Add resources the upstream doesn’t include (extra ConfigMaps, sidecars, network policies).
  • Roll back to a previous deployment with git revert.
  • Pin to a specific upstream version and update on your schedule.
Read the new Customize an installation via git guide.

Repositories REST API

New /v1/repositories endpoints let you list and inspect installation repositories programmatically. Each entry includes the clone URL, the latest deployed commit, and a content hash that lets you skip redundant deploys when nothing changed. See the Repositories API reference.

Read-only access tokens

Tokens minted for read-only consumers (deployment systems, CI artifacts) are now physically scoped to fetch operations on the platform side. A leaked read token cannot be used to push, regardless of how it gets misused.

Packages API

New /v1/packages endpoints expose the Package definitions backing your products, including the typed input schema served at /v1/packages/{id}/versions/{semver}/inputs. Use them to drive your own install flows, generate type-safe client SDKs, or audit which Package version every product points at. See the Packages API reference.
February 2026
AIAPINetworkingSecurityPlatform

AI and Agents: Platform MCP with Code Mode

AI agents can now manage Akua infrastructure through the Model Context Protocol. The new platform MCP server at akua.dev/mcp uses Code Mode. Instead of one tool per API endpoint, agents get two tools (search + execute) and write JavaScript to compose API calls in a sandboxed V8 isolate. Inspired by CodeAct research and powered by the open-source cnap-tech/codemode library.

Public REST API

Full RESTful API at api.akua.dev/v1 for managing workspaces, clusters, packages, products, installations, and repositories programmatically. Supports workspace-owned API tokens and JWT authentication. A workspace API token implies its workspace, so most calls need no workspace header; broad credentials select the workspace with the optional Akua-Context header. Powers both the CLI and the platform MCP server.

Cloudflare Tunnel Preview Domains

Instant *.cnap.app HTTPS URLs for every app, with no DNS setup or Cloudflare account required. Also supports custom domains using your own Cloudflare credentials, managed per-workspace in Settings.

Interactive Terminal

Shell into running containers directly from the dashboard. Select a pod and container, and get a fully interactive terminal session powered by xterm.js and WebSocket.

App Dashboard Overhaul

Redesigned app landing page with new branding, overhauled create flow, and dedicated install detail routes for better navigation.

Passwordless Authentication

New passwordless magic-link login experience.
January 2026
InfrastructurePlatform

Gateway API & HTTPRoutes

Full Gateway API support with HTTPRoute-based ingress. Configure routing rules for your apps without touching raw Kubernetes manifests.

Automatic Chart Generation

Akua now generates Helm charts from your application source code automatically, with no manual chart authoring needed.

Registry Proxy

Pull images through Akua’s registry proxy, enabling private registry support without exposing credentials to clusters.

MCP Server

Added a Model Context Protocol server with ArtifactHub tools for Helm chart discovery and management.
December 2025
PlatformInfrastructure

App Sourcing & Deployment

New app sourcing pipeline: connect GitHub repos, configure builds, and deploy to clusters with real-time status tracking. Includes GitHub builds with infinite scroll and image handling.

Real-Time Application Logs

Stream live logs from running pods directly in the dashboard.

Workspace & Cluster UX Improvements

Revamped workspace selection UI, cluster creation and import flows, and updated terminology from “Projects” to “Workspaces” across the platform.

Product Settings & Deployment

Enhanced product display with deploy functionality, product preview in the creation flow, and a new product settings step.
July 2025
PlatformInfrastructure

Quickstart Onboarding

New guided quickstart flow to get users from sign-up to first deployment. Includes pricing display and state persistence across navigation.

Self-Install for Merchants

Merchants can now trigger product installs into their own workspace without payment, enabling self-service testing.

OIDC Session Refresh

Automatic OIDC session refresh on tab activation, so no more expired sessions when switching back to the dashboard.

Global Search with Product Sheets

Search now surfaces catalog items with integrated product detail sheets.
June 2025
Infrastructure

Kubernetes as a Service

Provision and manage Kubernetes clusters directly from Akua. Includes worker node bootstrap, kubeconfig download, and full lifecycle management.
April 2025
Platform

Stripe Integration

Automatic Stripe customer creation for billing and payment flows.

Auto Migration

Database migrations now run automatically at startup, with no manual migration steps needed.

Test Infrastructure

Added comprehensive test suite foundation for the platform.
March 2025
Platform

Helm MVP

The foundational release: Helm-based products, cluster management, region support, and app installs. The core platform that everything else builds on.