airo: Deploy Projects to Your Production VPS

Overview

Airo turns a local project and an airo.yaml configuration into a Docker-based deployment to a production VPS. It combines image building with delivery and deployment, so a developer can release from their computer without setting up a separate deployment platform.

The project is aimed at people comfortable managing their own server who want less deployment overhead for smaller projects. Its SSH and registry deployment modes offer different ways to transfer images, while keeping the workflow driven by a single CLI.

Key Features

• Builds Docker images from a local project context.
• Deploys images directly to a server over SSH or through a registry.
• Combines build, push, and deploy into an airo release command.
• Reads image and deployment settings from airo.yaml.
• Supports per-image base image and target architecture configuration.
• Configures containers with ports, environment files, and networks.
• Provides commands to check deployment status and list tags.

Use Cases

• A solo developer can release a side project from a local machine to a VPS without adopting a full PaaS.
• A small team managing its own server can use a shared project configuration to make deployments repeatable.
• A project owner can deploy through an existing image registry when direct image transfer over SSH is not suitable.
• Developers who want control over their server and deployment setup can automate container updates without introducing a larger orchestration stack.

Project Facts

• Language: Go
• License: MIT
• Stars: 514
• Forks: 25
• Topics: devops, self-hosted
• Archived: No

Getting Started

Clone the repository and install from source:

git clone https://github.com/bypirob/airo.git
cd airo
make install

Create an airo.yaml for your project, then use airo release to build and deploy. See the README for configuration and command details.

Alternatives

• 1Panel: 1Panel manages server services, websites, and containers through a web control panel rather than focusing on a Go CLI that builds and deploys images.

Considerations

Airo is designed for Docker-based deployments to servers you manage, so it is not a hosted deployment service and does not remove the need to configure or operate a VPS. You will need Docker image build inputs and either SSH access to the target server or a configured registry. The supplied information does not specify support for operating systems, authentication options beyond SSH identity configuration, or advanced orchestration features, so check the README before relying on those capabilities.