Title: Self-hosted GitHub Actions runners on Linux and Ubuntu · Codemany URL: https://codemany.com/linux Description: Run GitHub Actions jobs on your own Ubuntu or Debian machine. Codemany sets up self-hosted runners and gives every job a fresh one. Install the .deb or use apt. All pages as Markdown: https://codemany.com/llms.txt --- linux # Self-hosted GitHub Actions runners on your Linux machine. Run your GitHub Actions jobs on your own Ubuntu or Debian box: a desktop, a server or a VM. Codemany sets up the runners and gives every job a fresh one. 1. **Install it.** The .deb, apt, or one command on a server. 2. **Connect GitHub.** Sign in and pick repositories. 3. **Change one line:** `runs-on: [self-hosted, Linux, codemany]` Checksummed packages, a signed apt repository, and updates with `apt upgrade`. ## Codemany for Linux Debian and Ubuntu .deb · amd64 and arm64 [.deb amd64](https://codemany.com/download/linux/codemany-desktop_latest_amd64.deb) [.deb arm64](https://codemany.com/download/linux/codemany-desktop_latest_arm64.deb) Servers and VMs, one command ([guide](https://codemany.com/docs/machines#linux)): `curl --proto '=https' --tlsv1.2 -fsSL https://codemany.com/install.sh | sh` ### Or use apt (Debian, Ubuntu) ``` curl --proto '=https' --tlsv1.2 -fsSLo codemany.gpg https://codemany.com/download/linux/apt/codemany-archive-keyring.gpg gpg --show-keys --with-colons codemany.gpg | grep -qx 'fpr:::::::::92EAE8F4E140E71FE883C291DBC1D8717AE5E521:' && sudo install -m 644 codemany.gpg /usr/share/keyrings/codemany-archive-keyring.gpg echo "deb [signed-by=/usr/share/keyrings/codemany-archive-keyring.gpg] https://codemany.com/download/linux/apt stable main" | sudo tee /etc/apt/sources.list.d/codemany.list sudo apt update && sudo apt install codemany codemany-desktop # apt upgrade updates both ``` The key is installed only if its fingerprint is `92EA E8F4 E140 E71F E883 C291 DBC1 D871 7AE5 E521`. **Price** [$20/month for 2 machines](https://codemany.com/pricing) **Trial** 14 days, no card **Requires** 64-bit Linux, systemd ## One window for your runners The same places as the Mac app: Overview, Runs, Machines, Repositories, Plan & Billing, This machine and Account. ![Codemany Overview on Linux: three of four jobs running, each on a fresh runner, with jobs done and money saved.](https://codemany.com/screenshots/linux/overview.png) Overview: what runs now, what waits, and what you saved against hosted runners. ![Codemany Runs: workflow runs from several repositories, filtered by workflow and status.](https://codemany.com/screenshots/linux/runs.png) Runs: every workflow run across your repositories, queued, running or done. ![Codemany Machines: three Linux machines, each running several jobs at once.](https://codemany.com/screenshots/linux/machines.png) Machines: your Linux boxes, how many jobs each runs at once, and free slots. ## Why run GitHub Actions on your own Linux box - **A fresh runner for every job**No state left over from the last job. - **A VM per job with KVM**Docker and sudo inside, the host untouched. - **Several jobs at once**Pick how many jobs each machine runs in parallel. - **Your code stays on your machine**GitHub schedules the jobs and shows the logs. - **Runs as a systemd service**It starts at boot, with or without a desktop. - **Mix Linux and Mac**One account for all your machines; `runs-on` picks the OS. ## Supported distros and requirements - **Desktop app**A .deb for Debian and Ubuntu, amd64 (x86\_64) and arm64. - **Servers and VMs**Any 64-bit Linux with systemd: Ubuntu 22.04 or 24.04, Debian 12 or newer, Fedora and others. - **Init system**systemd runs Codemany's background service. - **GitHub**An account that can add self-hosted runners (repo admin, or org owner). ## FAQ **How do I run GitHub Actions on my own Linux machine?** Install Codemany, sign in with GitHub and pick repositories. Then change one line in your workflow: `runs-on: [self-hosted, Linux, codemany]`. Codemany registers the self-hosted runners and gives every job a fresh one. **Which Linux distributions does Codemany support?** Any 64-bit Linux with systemd: Ubuntu 22.04 or 24.04, Debian 12 or newer, Fedora and others. The desktop app is a .deb for Debian and Ubuntu on amd64 and arm64; servers install with one command. **Are jobs isolated from each other?** Yes. On a machine with KVM, each job gets a fresh virtual machine with Docker and sudo. Without KVM, jobs run as your user on the host. Switch at any time with `codemany isolation vm` or `codemany isolation host`. **Does my code leave my machine?** No. Everything that touches your code runs on your machine. GitHub still schedules the jobs and shows the logs. Codemany's servers only handle plans, the console, this website and downloads. **How much does it cost?** 14 days free, no card. Then $20/month for 2 machines. ## Next [Linux setup guide](https://codemany.com/docs/machines#linux) [Pricing](https://codemany.com/pricing) [All downloads, macOS too](https://codemany.com/download)