Akua is built for deploying software to customer infrastructure (hospitals, banks, enterprises with strict compliance requirements). Security is foundational to the architecture, not an add-on.Documentation Index
Fetch the complete documentation index at: https://docs.akua.dev/llms.txt
Use this file to discover all available pages before exploring further.
Your data, your infrastructure
Unlike platforms that host your workloads on shared infrastructure, Akua runs your applications on your servers or dedicated clusters you control.Isolation model
Per-customer cluster isolation
Every managed cluster is a fully isolated with its own:- Kubernetes API server
- Isolated state store (separate from other clusters)
- RBAC and service accounts
- Certificate authority
Workspace isolation
Workspaces are the organizational boundary in Akua. Each workspace has:- Separate Stripe billing (merchant account for marketplace sellers)
- Independent resource quotas
- Own cloud credentials (BYOM keys are workspace-scoped)
- Separate clusters, products, and deployments
Secrets and credentials
Akua uses a workspace-scoped secret store for all runtime credentials (CEP-0041). This applies to cloud provider API keys, container registry credentials, webhook signing secrets, and agent provider keys. Key properties of the secret store:- Plaintext is never stored in configuration metadata. Secret values are stored in an external secrets manager; Akua keeps only a reference.
- Versioned rotation. Secrets support append-only versioning: rotate by adding a new version and moving the
currentalias. Previous versions are accessible until explicitly disabled or destroyed. - Separate access scope. Reading secret metadata (
secrets:read) and reading plaintext (secrets:access) are separate scopes. Every plaintext access attempt is audited. - Soft delete with recovery. Deleted secrets enter a 30-day recovery window before permanent removal.
Data residency
With BYOM (bring your own machine), the customer controls where data lives:- Choose your cloud provider: Hetzner (EU/US), AWS, GCP, or any supported provider.
- Choose your region: Falkenstein, Frankfurt, Ashburn, or wherever your compliance requires.
- Data stays on your servers: Akua’s control plane sends orchestration commands and does not store or process customer application data.
Some optional features route data through Akua (see details)
Some optional features route data through Akua (see details)
| Feature | What passes through Akua | Customer data visible? |
|---|---|---|
| AI code execution (Code Mode) | Your code snippets and execution results | Yes (code you write is processed) |
| Custom dashboards | Kubernetes API queries and responses | Only resource metadata (pod names, statuses), not application data |
| Kubernetes API proxy | kubectl commands and responses | Cluster metadata only (not application payloads or volumes) |
| Log streaming | Container stdout/stderr | Depends on what your app logs; avoid logging sensitive data |
| Preview domains | HTTP traffic (TLS terminated at edge) | Request/response passes through Cloudflare, not Akua servers |
For the strictest requirements, customers can run workers on their own on-premise servers. Run the bootstrap command → and the server joins Akua’s managed cluster. Your data never leaves your network.
Encryption
| Layer | Protection |
|---|---|
| Control plane ↔ worker | TLS with automatic certificate rotation |
| API access | HTTPS only, TLS 1.2+ |
| Authentication | OAuth2, session tokens, ServiceAccount JWTs |
| Cloud credentials | Stored as references to an external secrets manager (actual tokens are never in the configuration database) |
| Worker bootstrap tokens | Short-lived, configurable expiry |
Authentication and access control
- Dashboard: OAuth2 via GitHub, Google, or email magic link.
- API: Workspace API tokens or OAuth2 Bearer (JWT) tokens.
- Internal services: Kubernetes ServiceAccount JWT with JWKS verification.
- Workspace membership: Role-based (owner), scoped to workspace resources.
What Akua stores versus what stays on your infrastructure
Stored by Akua (configuration metadata):- Workspace settings, user accounts, billing state.
- Product definitions, Helm chart references, deployment configurations.
- Helm value overrides you configure in the dashboard.
- Machine records, cluster metadata, quota usage counters.
- Your application runtime data (databases, files, user-generated content).
- Your container images (stored in your registry; Akua only stores the image reference).
- Your Kubernetes secrets (stored in your cluster’s isolated data store).
- Your cloud provider API tokens (stored as references to an external secrets manager, not in Akua’s configuration database).
On-premise and air-gapped deployments
Akua supports deploying to servers behind firewalls and in restricted networks:- The customer’s server initiates an outbound-only connection to the Akua control plane.
- No inbound ports need to be opened.
- The bootstrap command handles all setup (Kubernetes install, cluster join, certificate exchange).
- Once connected, the worker communicates through a secure tunnel back to the control plane.
Compliance roadmap
| Certification | Status | Timeline |
|---|---|---|
| GDPR | Architecture supports EU data residency; formal assessment in progress | Current |
| SOC 2 Type II | Planned | 2026–2027 |
| ISO 27001 | Planned | 2026–2027 |
| DORA (Digital Operational Resilience Act) | Under evaluation | TBD |
- Architecture security review documentation.
- Data flow diagrams showing isolation boundaries.
- Infrastructure audit support (we participate in your vendor assessment).
- Custom DPAs (Data Processing Agreements).
Reporting vulnerabilities
If you discover a security vulnerability, report it to security@akua.dev. We take all reports seriously and will respond within 48 hours.Related topics
Add workers
Bootstrap command for connecting your own servers.
Secrets API
Manage workspace secrets and credential rotation.
Compute providers
Where your workloads run.
Enterprise
Custom limits, compliance support, dedicated infrastructure.