ghalet documentation

日本語

ghalet is a lightweight controller for GitHub Actions self-hosted runners on Linux and macOS. A single Go daemon starts native runner processes on demand and manages capacity across repositories and organizations.

It is intended for dedicated, trusted hosts, from build machines and single-purpose VMs to home servers. Runners are not strictly isolated from one another; use only trusted workflows.

Get started

• Getting started : installation, authentication, configuration, your first workflow, and macOS service setup.
• Packages and containers : Linux packages with systemd, Docker Compose, and updates.

Authentication

• Authentication setup : choose GitHub CLI, PAT, or GitHub App authentication and configure the required permissions.
• GitHub App setup : create and install an App with the setup wizard, including remote hosts and systemd services.
• Ordinary credential files : register, replace, and roll back credentials stored as files.
• Encrypted systemd credentials : manage service credentials on Linux.

Operation and reference

• Operations : configuration, execution users, scaling, recovery, logs, service deployment, and trust boundaries.
• Commands : CLI command overview.
• Example configuration and configuration schema .