🏋️ slaves.wtf
Self hosting

Bare Metal

Run your slave directly on your machine

Run a slave directly on your system without containers.

Prerequisites

  • Node.js >= 22.12.0
  • pnpm >= 9.0.0
  • A supported OS (macOS, Linux, Windows via WSL)

Install

git clone https://github.com/DecOperations/slaves.wtf.git
cd slaves.wtf/core
pnpm install
pnpm build

Configure

pnpm slaves config

Run as daemon

pnpm slaves start

The slave installs itself as a system daemon:

  • macOS: launchd (~/Library/LaunchAgents/)
  • Linux: systemd (~/.config/systemd/user/)

Manual run (foreground)

For development or debugging:

pnpm slaves gateway

This runs the slave in the foreground with full log output.

Updating

Pull upstream changes and rebuild:

git pull
cd core
pnpm install
pnpm build
pnpm slaves restart

Previous

Introduction

Next

Docker

On this page