# Airship > Airship launches a fresh machine in your own AWS, Google Cloud or Azure account for every GitHub Actions job, from one airship.yaml per repository. - [GitHub Actions runners in your own cloud](https://docs.airshipci.com/index.md): Every GitHub Actions job gets a fresh machine in your own cloud account, described by one file in your repository. - [Quickstart](https://docs.airshipci.com/quickstart.md): Connect a cloud, activate a repository, and run your first job on a machine you own. - [How it works](https://docs.airshipci.com/how-it-works.md): What happens between a queued GitHub job and a terminated machine, and what keeps the two in step. - [Concepts](https://docs.airshipci.com/concepts.md): The words Airship uses, and what each one means in your account and in your repository. - [Connecting a cloud](https://docs.airshipci.com/clouds/overview.md): What Airship needs from AWS, Google Cloud or Azure, what it creates there, and how the credential is held. - [Amazon Web Services](https://docs.airshipci.com/clouds/aws.md): The IAM policy, the network, the quotas and the settings for running jobs on EC2. - [Google Cloud](https://docs.airshipci.com/clouds/google-cloud.md): The service account, the roles, the organization policies and the settings for running jobs on Compute Engine. - [Microsoft Azure](https://docs.airshipci.com/clouds/azure.md): The Entra application, the role, the policies and the settings for running jobs on Azure virtual machines. - [airship.yaml](https://docs.airshipci.com/configuration/overview.md): The file that defines your runners: every field, what it accepts, and what each cloud does with it. - [Labels and runs-on](https://docs.airshipci.com/configuration/labels.md): How a job asks for a machine, why the run_id suffix matters, and how matrix jobs get a machine each. - [Machine types](https://docs.airshipci.com/configuration/machines.md): Picking a size, how architecture is decided, and what GPUs need on each cloud. - [Machine images](https://docs.airshipci.com/configuration/images.md): The defaults, every form machine_image accepts on each cloud, and how to point at an image of your own. - [Fallbacks and spot](https://docs.airshipci.com/configuration/fallbacks.md): Lists of instance types, images, regions and spot settings, how they are combined, and when a failed launch is retried. - [Disks](https://docs.airshipci.com/configuration/storage.md): Sizing the root volume, raising throughput, and attaching extra or existing disks. - [Networking](https://docs.airshipci.com/configuration/networking.md): Where runners launch, what they need to reach, and how to put them on a private network with no public address. - [Environment and identity](https://docs.airshipci.com/configuration/environment.md): Setting environment variables for every job, giving a runner a cloud identity, and provisioning from your own image. - [Windows runners](https://docs.airshipci.com/configuration/windows.md): Running jobs on Windows, including an interactive desktop session for tests that need one. - [One-line runners](https://docs.airshipci.com/configuration/one-line-runners.md): Describe the machine in the label itself, with no config file at all. - [Cache acceleration](https://docs.airshipci.com/performance/caching.md): Drop-in actions/cache backed by a bucket in your own account, with no size limit and no network round trip to GitHub. - [Idle runners](https://docs.airshipci.com/performance/idle-runners.md): Keep machines booted and registered so a job starts in seconds instead of minutes. - [Custom images](https://docs.airshipci.com/performance/custom-images.md): Bake the runner and your toolchain into an image so every job skips the download and the install. - [Organization-wide runners](https://docs.airshipci.com/organization/runners.md): Define machine shapes once in a .airship repository and let every activated repository use them. - [Access control](https://docs.airshipci.com/organization/access-control.md): Restrict who may launch an expensive runner, by repository, team, repository role or login. - [Capacity and limits](https://docs.airshipci.com/organization/capacity.md): The ceiling on live runners, how it is enforced, and the other bounds Airship holds you to. - [The dashboard](https://docs.airshipci.com/dashboard.md): What each page shows, and which one to open when something is wrong. - [Troubleshooting](https://docs.airshipci.com/troubleshooting.md): Why a job was not run, why a launch failed, and what each runner state means. - [Security and trust](https://docs.airshipci.com/security.md): What Airship holds, what it can do, what a job can reach, and the exposures that come with the model rather than being bugs in it. - [Self-hosting Airship](https://docs.airshipci.com/self-hosting/overview.md): Run the control plane on your own infrastructure: one container, one Postgres database, and a GitHub App of your own. - [The GitHub App](https://docs.airshipci.com/self-hosting/github-app.md): Creating your own app: URLs, permissions, events, and what each permission is actually used for. - [Configuration](https://docs.airshipci.com/self-hosting/configuration.md): Every environment variable the control plane reads, what is required, and what must never be set in production. - [Deploying](https://docs.airshipci.com/self-hosting/deploying.md): Where to run the control plane, the checklist every deployment has to pass, and how to operate it. - [Developer API](https://docs.airshipci.com/api-reference/introduction.md): Activate repositories, connect clouds and change runner access policies from a script. - [List repositories](https://docs.airshipci.com/api-reference/developer-api/list-repositories.md) - [Activate or deactivate a repository](https://docs.airshipci.com/api-reference/developer-api/activate-or-deactivate-a-repository.md) - [List connected clouds](https://docs.airshipci.com/api-reference/developer-api/list-connected-clouds.md) - [Connect a cloud](https://docs.airshipci.com/api-reference/developer-api/connect-a-cloud.md) - [Read access policies](https://docs.airshipci.com/api-reference/developer-api/read-access-policies.md) - [Change access policies](https://docs.airshipci.com/api-reference/developer-api/change-access-policies.md) - [Fetch a runner's boot script](https://docs.airshipci.com/api-reference/developer-api/fetch-a-runners-boot-script.md) ## OpenAPI Specs - [openapi](/api-reference/openapi.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.