Loading…

Add your Mac to the hive

One command installs the daemon, signs this Mac in with GitHub and starts it. From then on the Mac runs your organization's jobs in throwaway VMs whenever it is awake.

Terminal

curl -fsSL https://get.hiveworkr.thecomputerplumbers.com/install.sh | sh

Paste it into Terminal. A browser window opens for you to sign in with GitHub and approve this Mac; being a member of your GitHub organization is what lets it join. What the daemon does

What the command does

Downloads the daemon and the Linux image jobs run in, about 300 MB, and checks both against their published checksums.
Installs them under your home directory. Nothing is installed system-wide and it never asks for your password.
Opens your browser to sign this Mac in with GitHub.
Starts the daemon as a background service for your user, so it comes back after a restart.

The daemon is signed and notarized by Apple under the developer ID Layups AI LLC, and the installer refuses a download signed by anyone else.

What you need

A Mac with Apple Silicon, or a Linux machine with KVM. Intel Macs are not supported.
macOS 13 or later, and about 3 GB of free disk.
A GitHub account that belongs to an organization with the Hive Runner GitHub App installed.
An outbound internet connection. The daemon needs no inbound ports and no changes to your router or firewall.

Once it is running

hived status: What this Mac lends, and whether it is lending.
hived pause: Stop taking jobs. hived resume undoes it.
hived config: How many jobs at once, how large, during which hours, and the size of the local Actions cache.
hived cache: What the local Actions cache holds.

Updating and removing

To update, run the install command again when the Mac is idle. To remove everything it installed, run hived uninstall.

Removing the daemon leaves the Mac listed in your hive as offline. Remove it from Machines in the dashboard.

Other platforms

The same command works on Linux, arm64 or x64, on a machine with KVM. It needs QEMU, virtiofsd and passt, and tells you how to install whichever is missing; it never asks for your password.

A Windows 11 PC with an Intel or AMD processor lends itself through Windows' Linux subsystem (WSL 2). Paste this into PowerShell; it sets up a Linux of its own for the daemon and runs the same install inside it. The PC takes x64 jobs while you are signed in to Windows.

PowerShell

irm https://get.hiveworkr.thecomputerplumbers.com/install.ps1 | iex