https://github.com/hostinger/fireactions

BYOM (Bring Your Own Metal) and run self-hosted GitHub runners in ephemeral, fast and secure Firecracker based virtual machines.
https://github.com/hostinger/fireactions

fireactions github github-actions github-runners tools

Last synced: 8 days ago
JSON representation

BYOM (Bring Your Own Metal) and run self-hosted GitHub runners in ephemeral, fast and secure Firecracker based virtual machines.

• Host: GitHub
• URL: https://github.com/hostinger/fireactions
• Owner: hostinger
• License: apache-2.0
• Created: 2023-09-26T08:13:41.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2026-01-28T11:15:47.000Z (17 days ago)
• Last Synced: 2026-01-29T02:04:20.020Z (16 days ago)
• Topics: fireactions, github, github-actions, github-runners, tools
• Language: Go
• Homepage: https://fireactions.io
• Size: 21.1 MB
• Stars: 124
• Watchers: 5
• Forks: 11
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: CODEOWNERS

Awesome Lists containing this project

• awesome-microvm - Fireactions - BYOM (Bring Your Own Metal) and run self-hosted GitHub runners in ephemeral, fast and secure Firecracker based virtual machines. (Projects / Security)

README

          
[![Go Report Card](https://goreportcard.com/badge/github.com/hostinger/fireactions)](https://goreportcard.com/report/github.com/hostinger/fireactions)

![Banner](docs/img/banner_violet.png)

Fireactions is an orchestrator for GitHub runners. BYOM (Bring Your Own Metal) and run self-hosted GitHub runners in ephemeral, fast and secure [Firecracker](https://firecracker-microvm.github.io/) based virtual machines.

> [!IMPORTANT]

> There's been multiple improvements with a lot of breaking changes. The current stable version is **v2.0.0**. Please use this version for production environments.

![Architecture](docs/img/architecture.png)

Several key features:

- **Scalable**

  Pool based scaling approach. Fireactions always ensures the minimum amount of GitHub runners in the pool.

- **Ephemeral**

  Each virtual machine is created from scratch and destroyed after the job is finished, no state is preserved between jobs, just like with GitHub hosted runners.

- **Customizable**

  Define job labels and customize virtual machine resources to fit Your needs.

## Quickstart

```bash

$ fireactions --help

BYOM (Bring Your Own Metal) and run self-hosted GitHub runners in ephemeral, fast and secure Firecracker based virtual machines.

Usage:

  fireactions [command]

Main application commands:

  server      Starts the server

  agent       Starts the agent and GitHub Actions runner inside the VM

Pool management commands:

  pools       Manage pools

Machine management commands:

  ps          List all running machines across all pools

  login       SSH into a running VM as root user

  logs        Stream logs from the fireactions-agent service inside a machine

Image management commands:

  image       Manage images

Additional Commands:

  version     Show version information

  help        Help about any command

  completion  Generate the autocompletion script for the specified shell

Flags:

  -h, --help      help for fireactions

  -v, --version   version for fireactions

Use "fireactions [command] --help" for more information about a command.

```

See the [User Guide](https://fireactions.io/latest/) for installation and configuration instructions.

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for more information on how to contribute to Fireactions.

## License

See [LICENSE](LICENSE)