# A-Line.cloud docs > Run apps, databases and sites on your own Kubernetes clusters in European data centres: the console, infrastructure as code, the v1 API, Actions runners and AI clients over MCP. Every page in one file: https://docs.a-line.cloud/llms-full.txt. Each link below is the page as markdown; drop the `.md` for the HTML page, or ask for it with `Accept: text/markdown`. AI clients connected to the A-Line.cloud MCP server at https://mcp.a-line.cloud (setup: https://docs.a-line.cloud/mcp.md) can also search these docs with the `search_docs` and `read_doc` tools. The v1 API as an OpenAPI 3 document: https://docs.a-line.cloud/openapi/v1.json. ## Overview - [Overview](https://docs.a-line.cloud/index.md): Run apps, databases and sites on your own Kubernetes clusters. ## Getting started - [Getting started](https://docs.a-line.cloud/getting-started.md): What A-Line.cloud is, and the steps from sign-up to an app running on your own domain. - [Sign up](https://docs.a-line.cloud/getting-started/sign-up.md): Sign in for the first time and create your organization. - [Create a cluster](https://docs.a-line.cloud/getting-started/create-cluster.md): Create the cluster your projects and apps run on. - [Create a project](https://docs.a-line.cloud/getting-started/create-project.md): Create the project that groups your apps. - [Deploy an app](https://docs.a-line.cloud/getting-started/deploy-app.md): Run a container image as an app in your project. - [Add a domain](https://docs.a-line.cloud/getting-started/add-domain.md): Route a host on your own domain to an app and verify you own the domain. ## Guides - [Guides](https://docs.a-line.cloud/guides.md): Step-by-step guides for deploying apps, static sites, databases, domains, storage, scaling and CI on A-Line.cloud. - [Deploy an app from GitHub](https://docs.a-line.cloud/guides/deploy-from-github.md): Build a container from a GitHub repository and redeploy it on every push. - [Deploy a static site](https://docs.a-line.cloud/guides/static-site.md): Publish a static site from a Git repository or an uploaded archive, and roll back to an earlier version. - [Add a custom domain](https://docs.a-line.cloud/guides/custom-domain.md): Serve an app on your own host name over HTTPS, with A/AAAA records or a CNAME. - [Add a database and connect an app](https://docs.a-line.cloud/guides/managed-database.md): Create a managed PostgreSQL or Valkey and give an app short-lived credentials for it. - [Store secrets](https://docs.a-line.cloud/guides/secrets.md): Keep API keys and passwords out of your code and hand them to apps as variables or files. - [Use object storage](https://docs.a-line.cloud/guides/object-storage.md): Create an S3-compatible bucket, make an access key and attach the bucket to an app. - [Keep data with volumes and backups](https://docs.a-line.cloud/guides/volumes-and-backups.md): Give an app a persistent volume, back it up on a schedule and restore it. - [Read logs and metrics](https://docs.a-line.cloud/guides/logs-and-metrics.md): Follow an app's logs live, search its history and watch its CPU, memory and requests. - [Scale an app automatically](https://docs.a-line.cloud/guides/autoscaling.md): Add and remove replicas of an app as its load changes, down to zero when it is idle. - [Run apps on their own servers](https://docs.a-line.cloud/guides/dedicated-clusters.md): Add a node pool, let it grow and shrink, cap its price and reserve it for chosen apps. - [Manage a project from Git](https://docs.a-line.cloud/guides/iac-project-link.md): Link a project to a folder in a GitHub repository, so its apps follow YAML files and changes go through pull requests. - [Run GitHub Actions jobs on A-Line.cloud](https://docs.a-line.cloud/guides/actions-runners.md): Connect GitHub, pick a runner size with a runs-on label and cap what your CI spends. ## Concepts - [Concepts](https://docs.a-line.cloud/concepts.md): The building blocks of A-Line.cloud and how they fit together. - [Organizations and environments](https://docs.a-line.cloud/concepts/organizations.md): Who owns what, and who may change it. - [Projects and apps](https://docs.a-line.cloud/concepts/projects-and-apps.md): How apps are grouped on a cluster. - [Template dependencies](https://docs.a-line.cloud/concepts/template-dependencies.md): Deploy a template app together with the database or cache it needs. - [Clusters and pools](https://docs.a-line.cloud/concepts/clusters-and-pools.md): The servers your apps run on. - [OVHcloud](https://docs.a-line.cloud/concepts/ovh.md): Run clusters on OVHcloud Public Cloud, in regions we run for you. - [Builds and deploys](https://docs.a-line.cloud/concepts/builds-and-deploys.md): How a change becomes a running app. - [Domains and certificates](https://docs.a-line.cloud/concepts/domains.md): Route your own host names to apps over HTTPS. - [Use a CDN or proxy](https://docs.a-line.cloud/concepts/cdn-proxy.md): Put Cloudflare, Fastly, Bunny, CloudFront or another proxy in front of an app domain. - [Backups](https://docs.a-line.cloud/concepts/backups.md): Backup policies, runs, targets and what a restore does. - [Keys](https://docs.a-line.cloud/concepts/keys.md): Encryption keys managed by the key service. Preview. ## Infrastructure as code - [Infrastructure as code](https://docs.a-line.cloud/iac.md): Describe clusters, projects and apps in YAML files kept in Git. - [Your first project](https://docs.a-line.cloud/iac/first-project.md): A cluster, a project and one app, as three YAML files. - [GitOps workflow](https://docs.a-line.cloud/iac/gitops.md): How linked repositories sync, how dashboard edits are written back and which changes wait for confirmation. - [Checking changes](https://docs.a-line.cloud/iac/check.md): Validate IaC files before they reach the tracked branch, locally or on every pull request. - [Import](https://docs.a-line.cloud/iac/import.md): Create projects and organization resources from a Git repository or a pasted document, and what an export leaves out. - [Recovery](https://docs.a-line.cloud/iac/recovery.md): Undo a change, back out of a removal, fix a failed sync and recover from a rewritten branch. - [Who can do what](https://docs.a-line.cloud/iac/permissions.md): The role each IaC action needs. - [Recipes](https://docs.a-line.cloud/iac/recipes.md): Complete examples for common setups. - [Clusters and pools](https://docs.a-line.cloud/iac/clusters.md): Describe a cluster, its node pools, load balancers and upgrade settings. - [Projects and apps](https://docs.a-line.cloud/iac/apps.md): Describe a project, its apps, where their containers come from and how they scale and deploy. - [Networking](https://docs.a-line.cloud/iac/networking.md): Domains, HTTP settings, connections between apps and projects, and outbound traffic. - [Databases and leases](https://docs.a-line.cloud/iac/databases.md): Declare database roles and grants on a managed database, and give apps short-lived credentials through leases. - [Environments and secrets](https://docs.a-line.cloud/iac/secrets.md): Declare environments and secret groups in an infrastructure link. Secret values never go in Git. - [Volumes, backups and cron jobs](https://docs.a-line.cloud/iac/data.md): Persistent volumes, sharing them between apps, backups and scheduled jobs. - [Buckets and storage](https://docs.a-line.cloud/iac/buckets.md): Managed buckets and connections to external S3 storage, declared in an infrastructure or project link. - [Domains and DNS zones](https://docs.a-line.cloud/iac/domains.md): Claim custom domains and host DNS zones from an infrastructure link. - [References](https://docs.a-line.cloud/iac/references.md): Fill an app's environment variables from buckets, storages, domains and other apps. - [IaC reference](https://docs.a-line.cloud/iac/reference.md): Every IaC file kind and field, generated from the JSON schema. - [Manifest](https://docs.a-line.cloud/iac/reference/manifest.md): Root `a-line.yaml` manifest. Can be self-contained or reference external files for infrastructure and projects. - [Infrastructure file](https://docs.a-line.cloud/iac/reference/infrastructure-file.md): Cluster infrastructure definition. - [Project file](https://docs.a-line.cloud/iac/reference/project-file.md): A project (Kubernetes namespace) with its applications. - [App file](https://docs.a-line.cloud/iac/reference/app-file.md): An application deployed within a project. - [Cluster file](https://docs.a-line.cloud/iac/reference/cluster-file.md): One cluster of an infra link. - [Bucket file](https://docs.a-line.cloud/iac/reference/bucket-file.md): A managed bucket. - [Storage file](https://docs.a-line.cloud/iac/reference/storage-file.md): An external storage connection. Its credentials are entered in the UI, or read from an environment secret group when `credentials:` is set. - [Site file](https://docs.a-line.cloud/iac/reference/site-file.md): One static site of a linked project. - [Secret group file](https://docs.a-line.cloud/iac/reference/secret-group-file.md): One secret group. - [Environment file](https://docs.a-line.cloud/iac/reference/environment-file.md): One environment. - [Key ring file](https://docs.a-line.cloud/iac/reference/key-ring-file.md): A key ring and its keys. - [Org bundle](https://docs.a-line.cloud/iac/reference/org-bundle.md): The whole document. - [Types](https://docs.a-line.cloud/iac/reference/types.md): Types shared by the IaC file kinds. - [Keys](https://docs.a-line.cloud/iac/keys.md): Declare key rings and keys in an infrastructure link. Key material never goes in Git. ## API - [API](https://docs.a-line.cloud/api.md): Automate A-Line.cloud with the v1 HTTP API. - [Authentication](https://docs.a-line.cloud/api/authentication.md): Create an API key, pick its scope and send it as a bearer token. - [Your first request](https://docs.a-line.cloud/api/first-request.md): List your clusters and create a project with an API key. - [Errors](https://docs.a-line.cloud/api/errors.md): The error envelope every non-2xx v1 response uses. - [Pagination](https://docs.a-line.cloud/api/pagination.md): Page through list operations with limit and cursor. - [Idempotency](https://docs.a-line.cloud/api/idempotency.md): Retry create requests safely with the Idempotency-Key header. - [Rate limits](https://docs.a-line.cloud/api/rate-limits.md): The per-key request budget and its headers. - [Versioning](https://docs.a-line.cloud/api/versioning.md): What may change within v1, and how removals are announced. - [API reference](https://docs.a-line.cloud/api/reference.md): The v1 API: base URL, authentication, limits, errors, pagination and every operation by group. - [Actions](https://docs.a-line.cloud/api/reference/actions.md): The actions operations of the v1 API. - [Apps](https://docs.a-line.cloud/api/reference/apps.md): The apps operations of the v1 API. - [Clusters](https://docs.a-line.cloud/api/reference/clusters.md): The clusters operations of the v1 API. - [Domains](https://docs.a-line.cloud/api/reference/domains.md): The domains operations of the v1 API. - [IaC](https://docs.a-line.cloud/api/reference/iac.md): The IaC operations of the v1 API. - [Logs](https://docs.a-line.cloud/api/reference/logs.md): The logs operations of the v1 API. - [Pricing](https://docs.a-line.cloud/api/reference/pricing.md): The pricing operations of the v1 API. - [Projects](https://docs.a-line.cloud/api/reference/projects.md): The projects operations of the v1 API. - [Secrets](https://docs.a-line.cloud/api/reference/secrets.md): The secrets operations of the v1 API. - [Whoami](https://docs.a-line.cloud/api/reference/whoami.md): The whoami operations of the v1 API. - [Schemas](https://docs.a-line.cloud/api/reference/schemas.md): Request and response bodies of the v1 API. ## Connect an AI client - [Connect an AI client](https://docs.a-line.cloud/mcp.md): Use A-Line.cloud from an AI client through MCP. - [Connect Claude Code](https://docs.a-line.cloud/mcp/claude-code.md): Connect Claude Code to A-Line.cloud over MCP. - [Connect Claude Desktop](https://docs.a-line.cloud/mcp/claude-desktop.md): Connect Claude Desktop to A-Line.cloud over MCP. - [Connect Cursor](https://docs.a-line.cloud/mcp/cursor.md): Connect Cursor to A-Line.cloud over MCP. - [Connect VS Code](https://docs.a-line.cloud/mcp/vscode.md): Connect VS Code to A-Line.cloud over MCP. - [Connect Generic JSON](https://docs.a-line.cloud/mcp/generic.md): Connect Generic JSON to A-Line.cloud over MCP. - [Tools](https://docs.a-line.cloud/mcp/tools.md): Every tool the A-Line.cloud MCP server offers, with its scope and arguments. ## Actions - [Actions](https://docs.a-line.cloud/actions.md): GitHub Actions runners on A-Line.cloud, billed per vCPU-minute. - [Runner sizing](https://docs.a-line.cloud/actions/runner-sizing.md): How A-Line.cloud measures each Actions job and suggests a bigger or smaller runner. - [Limits](https://docs.a-line.cloud/actions/limits.md): How many runners and vCPUs your organization runs at once, the largest build size, and how to ask for more. - [Actions insights](https://docs.a-line.cloud/actions/insights.md): Queue and run time, flaky jobs, duration regressions and your spend forecast. - [Long-running jobs](https://docs.a-line.cloud/actions/long-running-jobs.md): How jobs that run for hours are paid as they run, when they are stopped, and the GitHub limits that apply. ## Billing - [Billing](https://docs.a-line.cloud/billing.md): Prepaid credit, usage charges and what happens when credit runs out. - [Top up and control spend](https://docs.a-line.cloud/billing/top-up.md): Add credit once, monthly or automatically, get low-balance alerts and cap what logs and Actions cost.