# Aurora Documentation

> Sovereign cloud infrastructure for data and AI

Documentation links below point to plain-markdown renderings;
append `.md` to any documentation URL to get it.
`https://docs.aur.lu/llms-full.txt` contains all 135 pages
in one file (351 kB).

## Overview

- [Introduction](https://docs.aur.lu/docs/introduction.md): Learn how to use Aurora Object Storage, Inference, Compute, and the Portal API.
- [Docs for AI Agents](https://docs.aur.lu/docs/ai-agents.md): Every documentation page is available as plain markdown, alongside site-wide bundles sized for LLM context windows.
- [Support](https://docs.aur.lu/docs/support.md): How to reach Aurora for technical questions or problems.

## S3

- [Getting Started](https://docs.aur.lu/docs/s3/getting-started.md): This guide helps you log in and orient yourself in the Aurora Dashboard.
- [Buckets & API Keys](https://docs.aur.lu/docs/s3/buckets-and-api-keys.md): Buckets
- [Versioning & Encryption](https://docs.aur.lu/docs/s3/concepts/versioning-and-encryption.md): Aurora’s S3-compatible storage supports bucket versioning and server-side encryption to protect data at rest and simplify recovery from accidental changes or…
- [Object Lock & Retention](https://docs.aur.lu/docs/s3/object-lock.md): Object Lock provides write-once-read-many (WORM) protection for objects by preventing deletion or modification for a configured retention period. Aurora…
- [Gateway Data Architecture](https://docs.aur.lu/docs/s3/architecture/gateway-data-architecture.md): This page explains how Aurora’s data storage solutions work under the hood.
- [Multipart Uploads](https://docs.aur.lu/docs/s3/guides/multipart-uploads.md): Multipart upload lets you upload large objects in parts, enabling parallelism, retries of failed parts, and resuming interrupted transfers.
- [Data Migration Guide](https://docs.aur.lu/docs/s3/guides/migration.md): This guide covers moving data from existing S3-compatible systems to Aurora.
- [Performance Tuning](https://docs.aur.lu/docs/s3/guides/performance.md): Optimize throughput and latency when interacting with Aurora’s S3-compatible endpoints.
- [Security & Compliance](https://docs.aur.lu/docs/s3/guides/security-compliance.md): Aurora provides security controls to meet stringent compliance requirements.
- [Deleting Buckets](https://docs.aur.lu/docs/s3/guides/deleting-buckets.md): Deleting a bucket permanently removes it. Because deletion is irreversible, it is important to understand the requirements below before you proceed.
- [SDK – Python (boto3)](https://docs.aur.lu/docs/s3/sdks/sdk-python.md): Use boto3 to interact with Aurora’s S3-compatible endpoint.
- [SDK – Node.js (AWS SDK v3)](https://docs.aur.lu/docs/s3/sdks/sdk-nodejs.md): Interact with Aurora using the AWS SDK for JavaScript v3.
- [SDK – Go (aws-sdk-go-v2)](https://docs.aur.lu/docs/s3/sdks/sdk-go.md): Use the AWS SDK for Go v2 with a custom endpoint.
- [AWS CLI](https://docs.aur.lu/docs/s3/tools/aws-cli.md): Configure AWS CLI with your S3-compatible endpoint and Aurora credentials.
- [rclone](https://docs.aur.lu/docs/s3/tools/rclone.md): Configure an rclone remote for Aurora's S3-compatible storage.
- [Backup & Archival](https://docs.aur.lu/docs/s3/tools/backup-archival.md): Use Aurora's S3-compatible storage as a durable, offsite backup target.
- [Container Registry / Artifact Storage](https://docs.aur.lu/docs/s3/tools/container-registry.md): Use Aurora S3 as the object layer for OCI registries and charts.
- [Machine Learning & Data Science](https://docs.aur.lu/docs/s3/tools/ml-data-science.md): Aurora works with common ML tooling via S3-compatible URLs.
- [Analytics / Data Lake](https://docs.aur.lu/docs/s3/tools/analytics-data-lake.md): Run analytics directly against data in Aurora buckets.
- [Sync & File-Sharing](https://docs.aur.lu/docs/s3/tools/sync-file-sharing.md): Seafile (S3 backend)
- [CI/CD Artifacts & Cache](https://docs.aur.lu/docs/s3/tools/cicd-artifacts-cache.md): GitLab Runner (cache, artifacts)
- [Logging & Observability](https://docs.aur.lu/docs/s3/tools/logging-observability.md): Loki (boltdb-shipper, object store)
- [VM & Container Backups](https://docs.aur.lu/docs/s3/tools/vm-container-backups.md): Velero (Kubernetes)
- [Encryption Gateways / Object FS](https://docs.aur.lu/docs/s3/tools/encryption-gateways.md): rclone mount (FUSE)
- [ETL / Data Pipelines](https://docs.aur.lu/docs/s3/tools/etl-data-pipelines.md): Airbyte
- [Database Backups](https://docs.aur.lu/docs/s3/tools/database-backups.md): Postgres (pgBackRest)
- [Media & CDN Pipelines](https://docs.aur.lu/docs/s3/tools/media-cdn.md): Pimcore / Strapi / Ghost
- [Computation Checkpointing & Result Storage](https://docs.aur.lu/docs/s3/tools/checkpointing-results.md): Ray (checkpoints)
- [Limits & Quotas](https://docs.aur.lu/docs/s3/reference/limits-quotas.md): This page describes default limits for the Aurora S3 Platform. Quotas can be raised by contacting Aurora support.
- [Endpoints & Networking](https://docs.aur.lu/docs/s3/reference/endpoints-networking.md): Aurora exposes regional S3-compatible endpoints. Choose the endpoint closest to your compute or required data residency.
- [Troubleshooting](https://docs.aur.lu/docs/s3/reference/troubleshooting.md): Common issues and fixes when using Aurora’s S3-compatible API.
- [FAQ](https://docs.aur.lu/docs/s3/reference/faq.md): Is Aurora S3-compatible?

## Inference

- [Inference API](https://docs.aur.lu/docs/inference.md): Aurora Inference API lets you run large language models through an OpenAI-compatible API, with per-token billing and usage tracking. Connect coding agents…
- [Getting Started](https://docs.aur.lu/docs/inference/getting-started.md): Get an API Token
- [Models and pricing](https://docs.aur.lu/docs/inference/models-and-pricing.md): Inference usage is billed per 1 million tokens. Rates vary by model and token type:
- [List available models](https://docs.aur.lu/docs/inference/api-reference/list-inference-models.md): Returns the models enabled by default. No authentication is required. When the request carries an API token, the response applies the tenant's model overrides…
- [Retrieve a model](https://docs.aur.lu/docs/inference/api-reference/get-inference-model.md): Use the exact ID from GET /models. IDs can contain slashes (for example,
- [Create a chat completion](https://docs.aur.lu/docs/inference/api-reference/create-inference-chat-completion.md): Requires the execute:inference:requests permission and access to inference.
- [Create a text completion](https://docs.aur.lu/docs/inference/api-reference/create-inference-completion.md): Generate text from a prompt. Requires the execute:inference:requests
- [OpenAPI specification](https://docs.aur.lu/docs/inference/openapi.md): Download the Aurora Inference OpenAPI specification for API clients and tools.
- [OpenCode](https://docs.aur.lu/docs/inference/sdks/inference-opencode.md): Use Aurora as a custom provider in OpenCode, a terminal
- [Pi](https://docs.aur.lu/docs/inference/integrations/pi.md): Pi is an extensible terminal coding harness. Register Aurora
- [Hermes Agent](https://docs.aur.lu/docs/inference/integrations/hermes.md): Connect Nous Research's Hermes Agent
- [OpenClaw](https://docs.aur.lu/docs/inference/integrations/openclaw.md): Use Aurora as the inference provider for an OpenClaw
- [Aider](https://docs.aur.lu/docs/inference/integrations/aider.md): Aider pairs with you in the terminal to discuss and edit
- [Continue](https://docs.aur.lu/docs/inference/integrations/continue.md): Connect Continue to Aurora for IDE chat and editing.
- [Cline](https://docs.aur.lu/docs/inference/integrations/cline.md): Use Aurora with Cline by selecting its OpenAI Compatible
- [Chatbox AI](https://docs.aur.lu/docs/inference/integrations/chatbox.md): Use Chatbox AI with your Aurora token through a custom
- [Open WebUI](https://docs.aur.lu/docs/inference/integrations/open-webui.md): Connect a self-hosted Open WebUI instance to Aurora
- [OpenAI Python](https://docs.aur.lu/docs/inference/sdks/inference-python.md): Use the official openai Python library with Aurora's base URL and API token.
- [OpenAI JavaScript / TypeScript](https://docs.aur.lu/docs/inference/integrations/openai-javascript.md): Use the official openai package in Node.js or server-side TypeScript. The SDK's
- [Vercel AI SDK](https://docs.aur.lu/docs/inference/integrations/vercel-ai-sdk.md): Use the AI SDK with its OpenAI-compatible provider to
- [LangChain Python](https://docs.aur.lu/docs/inference/integrations/langchain.md): Use ChatOpenAI from langchain-openai for Aurora's standard Chat Completions
- [LiteLLM](https://docs.aur.lu/docs/inference/integrations/litellm.md): LiteLLM provides a shared Python interface across model

## Portal API

- [Quick start](https://docs.aur.lu/docs/portal-api/portal-api-overview.md): Anything you can do in the Portal web UI (managing tenants, buckets, access keys, compute instances, and more) you can automate through the Aurora Portal REST…
- [Responses & Errors](https://docs.aur.lu/docs/portal-api/portal-api-responses.md): All Portal API responses use Content-Type: application/json. This page describes the common response shapes, error format, and status codes.
- [OpenAPI Specification](https://docs.aur.lu/docs/portal-api/portal-api-openapi-spec.md): The Portal API is defined by an OpenAPI (Swagger) specification in JSON format. You can download the raw spec to generate HTTP client libraries, use it with…
- [Aurora Portal API](https://docs.aur.lu/docs/portal-api/reference/aurora-portal-api.md): Every action available in the Aurora Portal can be automated through these REST endpoints, authenticated with an API token.
- [Get tenant compute usage records](https://docs.aur.lu/docs/portal-api/reference/get-tenant-compute-usage.md): Returns compute usage records for the authenticated tenant in the given time range
- [[BETA] List volume snapshots](https://docs.aur.lu/docs/portal-api/reference/list-volume-snapshots.md): Returns a paginated list of snapshots for a volume
- [[BETA] Create volume snapshot](https://docs.aur.lu/docs/portal-api/reference/create-volume-snapshot.md): Creates a new snapshot for a volume. The volume must be in the 'Ready' state to perform this operation.
- [[BETA] Delete volume snapshot](https://docs.aur.lu/docs/portal-api/reference/delete-volume-snapshot.md): Deletes a volume snapshot by ID
- [[BETA] Get volume snapshot](https://docs.aur.lu/docs/portal-api/reference/get-volume-snapshot.md): Returns a volume snapshot by ID
- [[BETA] Restore volume snapshot](https://docs.aur.lu/docs/portal-api/reference/restore-volume-snapshot.md): Reverts a volume to the state captured by the given snapshot. The VM to which the volume is attached must be stopped before performing this operation.
- [Get tenant inference usage metrics](https://docs.aur.lu/docs/portal-api/reference/get-tenant-inference-usage.md): Returns inference usage metrics (token counts, requests, errors) for the authenticated tenant in the given time range, optionally resampled by window duration…
- [Get bucket operation metrics](https://docs.aur.lu/docs/portal-api/reference/get-bucket-operation-metrics.md): Returns S3 operation metrics for a bucket, optionally filtered by requester tenant and grouped by tags
- [Get tenant operation metrics](https://docs.aur.lu/docs/portal-api/reference/get-tenant-operation-metrics.md): Returns S3 operation metrics for the authenticated tenant in the given time range, optionally resampled by window duration and grouped by tags
- [Get bucket storage metrics](https://docs.aur.lu/docs/portal-api/reference/get-bucket-storage-metrics.md): Returns storage metrics for a bucket owned by the authenticated tenant
- [Get tenant storage metrics](https://docs.aur.lu/docs/portal-api/reference/get-tenant-storage-metrics.md): Returns storage metrics for the authenticated tenant in the given time range, optionally resampled by window duration
- [List tokens](https://docs.aur.lu/docs/portal-api/reference/list-tokens.md): Returns a list of all tokens for a tenant
- [Create token](https://docs.aur.lu/docs/portal-api/reference/create-token.md): Creates a new token with all portal permissions for a tenant
- [Delete token](https://docs.aur.lu/docs/portal-api/reference/delete-token.md): Deletes a tenant token by ID
- [Get token](https://docs.aur.lu/docs/portal-api/reference/get-token.md): Returns a tenant token by ID
- [Create token v2](https://docs.aur.lu/docs/portal-api/reference/create-token-v-2.md): Creates a new token with the requested portal permissions. At least one permission is required, and the requested permissions must not exceed those of the…
- [[BETA] List VM instances](https://docs.aur.lu/docs/portal-api/reference/list-instances.md): Returns a paginated list of VM instances for a tenant
- [[BETA] Create VM instance](https://docs.aur.lu/docs/portal-api/reference/create-instance.md): Handles the creation of a new virtual machine instance for a specific tenant. If sshKeys are provided, they are associated with the instance.
- [[BETA] Delete VM instance](https://docs.aur.lu/docs/portal-api/reference/delete-instance.md): Deletes a specific VM instance
- [[BETA] Get VM instance](https://docs.aur.lu/docs/portal-api/reference/get-instance.md): Returns details of a specific VM instance
- [[BETA] Update VM instance](https://docs.aur.lu/docs/portal-api/reference/update-instance.md): Updates details of a specific VM instance
- [[BETA] Force stop VM instance](https://docs.aur.lu/docs/portal-api/reference/force-stop-instance.md): Forcefully stops a specific VM instance
- [[BETA] Reboot VM instance](https://docs.aur.lu/docs/portal-api/reference/reboot-instance.md): Reboots a specific VM instance
- [[BETA] Update VM instance state](https://docs.aur.lu/docs/portal-api/reference/update-instance-state.md): Updates the state (e.g. start/stop) of a specific VM instance
- [[BETA] Change public IP address](https://docs.aur.lu/docs/portal-api/reference/change-public-ip-address.md): Changes or releases the public IP address of a VM instance
- [[BETA] List pending jobs](https://docs.aur.lu/docs/portal-api/reference/list-pending-jobs.md): Returns a list of pending asynchronous jobs for a tenant
- [[BETA] Get job info](https://docs.aur.lu/docs/portal-api/reference/get-job-info.md): Returns status and details of a specific asynchronous job
- [[BETA] List SSH keys](https://docs.aur.lu/docs/portal-api/reference/list-ssh-keys.md): Returns a list of SSH keys for a tenant
- [[BETA] Create SSH key](https://docs.aur.lu/docs/portal-api/reference/create-ssh-key.md): Creates a new SSH key for a tenant
- [[BETA] Delete SSH key](https://docs.aur.lu/docs/portal-api/reference/delete-ssh-key.md): Deletes a specific SSH key
- [[BETA] List VM offerings](https://docs.aur.lu/docs/portal-api/reference/list-offerings.md): Returns list of available VM offerings
- [[BETA] List VM templates](https://docs.aur.lu/docs/portal-api/reference/list-templates.md): Returns list of available VM templates
- [[BETA] List volumes](https://docs.aur.lu/docs/portal-api/reference/list-volumes.md): Returns a paginated list of volumes for a tenant
- [[BETA] Create volume](https://docs.aur.lu/docs/portal-api/reference/create-volume.md): Creates a new volume for a tenant
- [[BETA] Delete volume](https://docs.aur.lu/docs/portal-api/reference/delete-volume.md): Deletes a volume by ID
- [[BETA] Get volume](https://docs.aur.lu/docs/portal-api/reference/get-volume.md): Returns a volume by ID
- [[BETA] Detach volume](https://docs.aur.lu/docs/portal-api/reference/detach-volume.md): Detaches a volume from its current virtual machine
- [[BETA] Attach volume](https://docs.aur.lu/docs/portal-api/reference/attach-volume.md): Attaches a volume to a virtual machine
- [[BETA] Resize volume](https://docs.aur.lu/docs/portal-api/reference/resize-volume.md): Increases the size of a volume
- [[BETA] List VPCs](https://docs.aur.lu/docs/portal-api/reference/list-vp-cs.md): Returns a paginated list of VPCs for a tenant
- [[BETA] Create VPC](https://docs.aur.lu/docs/portal-api/reference/create-vpc.md): Creates a new VPC for a tenant
- [[BETA] Delete VPC](https://docs.aur.lu/docs/portal-api/reference/delete-vpc.md): Deletes a specific VPC
- [[BETA] Get VPC](https://docs.aur.lu/docs/portal-api/reference/get-vpc.md): Returns details of a specific VPC
- [[BETA] List VPC public IPs](https://docs.aur.lu/docs/portal-api/reference/list-vpc-public-ips.md): Returns a list of public IPs associated with a VPC
- [[BETA] Allocate and assign public IP to VPC](https://docs.aur.lu/docs/portal-api/reference/allocate-and-assign-public-ip-to-vpc.md): Allocates a new public IP and assigns it to a VPC
- [[BETA] Disassociate VPC public IP address](https://docs.aur.lu/docs/portal-api/reference/disassociate-vpc-public-ip-address.md): Disassociates and deallocates a public IP address from a VPC
- [[BETA] List networks](https://docs.aur.lu/docs/portal-api/reference/list-networks.md): Returns a paginated list of networks within a VPC
- [[BETA] Create network](https://docs.aur.lu/docs/portal-api/reference/create-network.md): Creates a new network within a VPC
- [[BETA] Delete network](https://docs.aur.lu/docs/portal-api/reference/delete-network.md): Deletes a specific network
- [[BETA] Get network](https://docs.aur.lu/docs/portal-api/reference/get-network.md): Returns details of a specific network
- [Get tenant inference credit balance](https://docs.aur.lu/docs/portal-api/reference/get-tenant-inference-credit-balance.md): Returns the inference credit balance for a tenant
- [List tenants](https://docs.aur.lu/docs/portal-api/reference/list-tenants.md): Returns the list of active tenants for the authenticated organization
- [Get tenant](https://docs.aur.lu/docs/portal-api/reference/get-tenant.md): Returns tenant details for the given tenant ID
- [List S3 access keys](https://docs.aur.lu/docs/portal-api/reference/list-s-3-access-keys.md): Returns the list of S3 access keys for the given tenant
- [Create S3 access key](https://docs.aur.lu/docs/portal-api/reference/create-s-3-access-key.md): Creates a new S3 access key for the given tenant
- [Delete S3 access key](https://docs.aur.lu/docs/portal-api/reference/delete-s-3-access-key.md): Deletes an S3 access key for the given tenant
- [Get S3 access key](https://docs.aur.lu/docs/portal-api/reference/get-s-3-access-key.md): Returns a single S3 access key for the given tenant
- [List buckets](https://docs.aur.lu/docs/portal-api/reference/list-buckets.md): Returns the list of active buckets for the given tenant
- [Create bucket](https://docs.aur.lu/docs/portal-api/reference/create-bucket.md): Creates a new bucket for the given tenant
- [Delete bucket](https://docs.aur.lu/docs/portal-api/reference/delete-bucket.md): Delete bucket for the given tenant
- [Get bucket](https://docs.aur.lu/docs/portal-api/reference/get-bucket-info.md): Returns bucket details for the given tenant and bucket name
- [Edit bucket](https://docs.aur.lu/docs/portal-api/reference/edit-bucket.md): Updates bucket configuration (currently only default retention for object lock buckets)
- [Clone object](https://docs.aur.lu/docs/portal-api/reference/clone-object.md): Creates a server-side clone of an object in the given bucket
- [Get tenant metrics](https://docs.aur.lu/docs/portal-api/reference/get-tenant-metrics.md): Returns summary metrics for the given tenant
- [List resource tags](https://docs.aur.lu/docs/portal-api/reference/list-tags.md): Returns list of tags for the given resource
- [Update resource tags](https://docs.aur.lu/docs/portal-api/reference/update-tags.md): Updates the list of tags for the given resource. Allowed characters for tag are: letters, numbers, spaces representable in UTF-8, and _ . : / = + - @

## Other

- [Completions](https://docs.aur.lu/docs/inference/api-reference/completions.md): Completions
- [Models](https://docs.aur.lu/docs/inference/api-reference/models.md): Models
- [Integrations](https://docs.aur.lu/docs/inference/integrations.md): Connect Aurora Inference to coding agents, chat applications, and libraries through

## API specifications

- [Inference API](https://docs.aur.lu/inference-api-spec.json): Machine-readable OpenAPI specification.
- [Portal API](https://docs.aur.lu/portal-api-spec.json): Machine-readable OpenAPI specification.

## Optional

- [Terms of Service](https://docs.aur.lu/docs/legal/terms.md): Effective date: 16 September 2026
- [Privacy Policy](https://docs.aur.lu/docs/legal/privacy-policy.md): Last updated: 28 July 2026
- [Legal Contact Points](https://docs.aur.lu/docs/legal/contact.md): Last updated: 28 July 2026
- [Data Act Information](https://docs.aur.lu/docs/legal/data-act.md): Last updated: 28 July 2026
- [Switching and Portability Annex](https://docs.aur.lu/docs/legal/switching.md): Effective date: 28 July 2026