{"name":"Airo: Effortless Project Deployment from Local to Production VPS","description":"Airo is a Go-based tool designed for simple and efficient deployment of projects from a local machine to a production VPS. It automates the process of building Docker images and deploying them via SSH or a registry, making it ideal for self-hosted side projects. This solution offers a straightforward alternative to complex CI/CD pipelines, focusing on speed and control.","github":"https://github.com/bypirob/airo","url":"https://osrepos.com/repo/bypirob-airo","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/bypirob-airo","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/bypirob-airo.md","json":"https://osrepos.com/repo/bypirob-airo.json","topics":["devops","self-hosted","Go","deployment","docker","vps","automation"],"keywords":["devops","self-hosted","Go","deployment","docker","vps","automation"],"stars":null,"summary":"Airo is a Go-based tool designed for simple and efficient deployment of projects from a local machine to a production VPS. It automates the process of building Docker images and deploying them via SSH or a registry, making it ideal for self-hosted side projects. This solution offers a straightforward alternative to complex CI/CD pipelines, focusing on speed and control.","content":"## Introduction\n\nAiro is an open-source tool written in Go that simplifies the deployment of your projects directly from your local computer to a production Virtual Private Server (VPS). It's designed to streamline the process of building Docker images and deploying them securely over SSH or through a Docker registry, all driven by a simple `airo.yaml` configuration file. Airo aims to make self-hosting projects accessible and efficient, reducing the complexity often associated with modern deployment strategies.\n\n## Installation\n\nTo get started with Airo, you can install it directly from the source code. Ensure you have Go installed on your system.\n\nbash\ngit clone https://github.com/bypirob/airo.git\ncd airo\nmake install\n\n\n## Examples\n\nAiro uses an `airo.yaml` file to define your project's images and deployment strategy. Here's a typical configuration example:\n\nyaml\nimages:\n  app:\n    base_image: node:24-alpine\n    target_arch: linux/amd64\ndeploy:\n  type: ssh # or registry\n  containers:\n    - name: \"app\"\n      image: \"app\"\n      port: 3000\n      app_port: 3000\n      env_file: \"/etc/airo/app.env\"\n      networks:\n        - \"frontend\"\n        - \"backend\"\n  ssh:\n    host: \"192.168.1.100\"\n    user: \"admin\"\n    port: 22\n    identity_file: \"~/.ssh/id_rsa\"\n  registry:\n    registry_url: \"registry.example.com\"\n    repository: \"my-app\"\n\n\nOnce configured, you can use various commands to manage your deployments:\n\nbash\nairo build --tag dev --context .\nairo push dev\nairo deploy --tag dev\nairo release --tag dev --context .\nairo status\nairo tags\nairo version\n\nThe `airo release` command combines building, pushing, and deploying into a single step.\n\n## Why Use Airo?\n\nAiro offers a compelling solution for developers who want to deploy their side projects without the overhead of complex infrastructure. While Kubernetes, PaaS, and extensive CI/CD pipelines are powerful, they can be overkill for simpler projects. Airo provides a cost-effective and controlled approach, allowing you to manage your server while still benefiting from automation. Key advantages include:\n\n*   **Focus on product development**, not infrastructure management.\n*   **Efficient Docker image handling**, building and delivering via registry or direct copy.\n*   **Instant deployment** with a single command from your local machine.\n*   **Secure and easy updates** for configurations and containers using SSH.\n\n## Links\n\nExplore the Airo project on GitHub for more details, contributions, and the latest updates:\n\n*   [Airo GitHub Repository](https://github.com/albersola/airo){:target=\"_blank\"}","metrics":{"detailViews":3,"githubClicks":4},"dates":{"published":null,"modified":"2026-05-03T15:35:21.000Z"}}