bypirob

airo: Deploy Docker Projects to Your VPS

Airo builds Docker images locally and deploys them to a VPS over SSH or through a container registry. It suits developers who want a direct, command-line deployment workflow and are comfortable managing their own server.

QuietGoMITDevOpsCLIDocker
View on GitHub Compare
Stars
514
Forks
25
Stars, last 30 days
+0
Last commit
9 months ago
Contributors
1

Our take

Quietno commits in the last 90 days and no release in a year

Health score

16/100

How it is scored
Activity
19
Community
4
Issues
21
Pull requests
20

+0 stars in the last 30 days

  • Fewer contributors than 91% of the projects we track

Airo offers a focused local-to-VPS workflow, but its quiet activity and dependence on a single contributor make it a cautious choice for production-critical adoption.

Good fit if

  • You want to deploy Docker-based projects to a VPS you manage, using SSH or a registry.
  • Your workflow can use a Go CLI and Docker, and you prefer deployments initiated from a local machine.
  • You are comfortable evaluating a MIT-licensed project with a small, concentrated contributor base.

Look elsewhere if

  • You need evidence of recent maintenance: the project has had no commits in the last 90 days and no release in over a year.
  • You need a project with multiple contributors or recent issue and pull request activity; the available measurements show one contributor and no recent closures or merges.
  • Your deployment depends on a workflow other than building and deploying Docker images to a VPS.
All health signals
Last commit2026-01-15 (9 months ago)
Commits, last 90 days0
Releases, last 12 months0 (latest v0.0.2, 2025-03-19)
Contributors1
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age19 months

Checked on 2026-10-10 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

513

Forks

25

Change since Nov 13, 2026: 0 stars·0 forks

Overview

Airo is a Go command-line tool for building Docker images on your computer and deploying them to a production VPS. It brings image building and delivery together with remote container deployment, configured through an airo.yaml file.

It is aimed at developers who prefer managing their own server and want a simpler alternative to setting up a larger CI/CD or orchestration platform for a project. Deployments can transfer images over SSH or use a registry.

Key Features

  • Build Docker images locally from a project context.
  • Deploy images to a VPS over SSH or through a container registry.
  • Run a release flow that builds, pushes, and deploys in one command.
  • Configure image targets, containers, ports, environment files, and networks in airo.yaml.
  • Set SSH connection details or registry settings in the project configuration.
  • Check deployment status and list local or remote tags from the CLI.
  • Generate a tag suffix automatically for releases when no tag is supplied.

Use Cases

  • A solo developer deploying a side project to a VPS without adding a hosted deployment platform.
  • A small team that already manages its own server and wants repeatable deployments from developer machines.
  • A project that needs a choice between copying images over SSH and publishing them to an existing registry.
  • A developer who wants to configure container settings alongside the project and trigger releases from the terminal.

What you need

Detected in the repository

  • Go 1.25.5 or newer (from go.mod)
  • A Dockerfile, so it can run in a container
  • Automated checks on GitHub Actions

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install from source:

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

See the README for configuration and command details.

Alternatives

  • uncloud: Uncloud deploys Docker and Compose apps across clustered cloud VMs or bare-metal hosts, rather than targeting a VPS over SSH or a registry.
ProjectLanguageLicenseStarsStatus
airoGoMIT514Quiet
uncloudGoApache-2.05.5kActive

Considerations

Airo requires Go 1.25.5 and Docker. The project is quiet by the available activity measures, has no tests indicated in its project facts, and its contributions are concentrated in one person. Assess whether that maintenance profile is acceptable before relying on it for important deployments. The MIT license permits broad use, subject to its license terms.

Found this useful?

Share it with someone who would like airo.

Comparisons