Skip to main content
A workspace switcher selecting one active workspace that holds clusters, products, billing, and members, while peer workspaces stay sealed and dimmed
A workspace is the unit of resource ownership in Akua. Clusters, products, installations, billing, and Stripe payments all belong to a workspace. Switch between workspaces in the sidebar to navigate between sets of resources. Workspaces are scoped to their members. Only people invited to a workspace, or members of an organization that manages it, can see it. Every workspace sits inside an organization. Akua creates the first organization automatically during onboarding, so solo users can start from a workspace-first experience while still having a durable organization to grow into later.

​
What a workspace contains

  • Clusters: Kubernetes infrastructure for deploying applications.
  • Regions: organizational labels for grouping clusters.
  • Products: sellable software packages you create.
  • Installations: running instances of your products and direct installs, each with its own package repository.
  • GitHub App installations: connected for automated installs.
  • Workspace members: users with direct access.
  • Organization: parent organization for team identity, member management, and managed customer workspace access.
  • Stripe account: one billing account per workspace for marketplace payments.

​
Workspaces vs organizations

These solve different problems. Use them together: If you’re a single user shipping a product, onboarding creates the organization for you and keeps the experience focused on your first workspace. When you add teammates, customers, or more environments, that organization becomes the shared identity that ties those workspaces together. If you sell software that your customers install on Akua, your organization gets admin access to each customer’s workspace through the managed-by relationship; your customers retain full ownership and billing control.

​
When to use separate workspaces

Even with an organization, you’ll often want multiple workspaces:
  • Environment separation: production, staging, and development as separate workspaces prevent accidental changes and keep clusters isolated.
  • Per-customer ownership: when you sell software, each customer gets their own workspace. They own it; your organization manages it. This keeps billing, data, and resources isolated per customer.
  • Independent business units: different legal entities, different Stripe accounts, or different teams that should never share resources.
  • Test isolation: short-lived workspaces for one-off projects, demos, or partner experiments.
Don’t reach for a new workspace just to organize resources within the same business and same team. Clusters, products, and installations can coexist in one workspace.

​
Workspace roles

Each member has a role that controls their permissions: The workspace creator is automatically assigned the owner role. Members of a managing organization get admin access automatically. See Organizations → Managed workspaces.

​
Managing the workspace

  • Switch workspaces from the sidebar switcher.
  • Selecting All Workspaces shows resources from every workspace you have access to.
  • Create, edit, invite members, or transfer ownership from Settings in the dashboard.

​
API

Manage workspaces, members, subscriptions, and access state programmatically.

Workspaces API

CRUD, member management, subscription, access state, and billing portal endpoints.

Authentication

Mint API tokens for programmatic access.

Organizations

Team and customer-management identity.

Billing

Manage your workspace subscription.

Create a cluster

Set up infrastructure in your workspace.

Plans and pricing

Resource quotas and plan limits per workspace.