# Rasputin

> Open-source homelab cluster system: Raspberry Pi and Intel N100 nodes plus a dedicated
> firewall node, managed from one web UI. Flash a card, boot, open http://rasputin.local.
> Pre-alpha, AGPL-3.0 — image layouts and update formats still change without notice.

Current stable: Rasputin OS 2026.07.4 · firewall 2026.07.4.

## Start here (AI agents)

- [Install with an AI agent](https://rasputin.geekdojo.com/docs/agents/index.md): The machine-readable install contract: non-interactive bootstrap.sh env vars, release manifests, the seed file, and how an agent verifies the cluster actually came up.
- [Packaged skill/plugin](https://github.com/geekdojo/rasputin-agents): Claude Code — `/plugin marketplace add geekdojo/rasputin-agents` then `/plugin install rasputin@geekdojo`; Codex/Agent-Skills clients — clone the repo and the skill auto-discovers.
- [Skill, raw](https://raw.githubusercontent.com/geekdojo/rasputin-agents/main/.agents/skills/rasputin-setup/SKILL.md): the rasputin-setup skill as plain markdown (no clone needed); [AGENTS.md, raw](https://raw.githubusercontent.com/geekdojo/rasputin-agents/main/AGENTS.md).

## Docs (raw markdown)
- [Getting started](https://rasputin.geekdojo.com/docs/getting-started/index.md): Zero to a working cluster: what you need, flash the first node, sign in with a passkey, add nodes, deploy an app.
- [Provisioning & the seed file](https://rasputin.geekdojo.com/docs/provisioning/index.md): How a node picks its role and joins the fleet — the rasputin-seed.env reference, starter to full options.
- [Install with an AI agent](https://rasputin.geekdojo.com/docs/agents/index.md): The machine-readable install contract: non-interactive bootstrap.sh env vars, release manifests, the seed file, and how an agent verifies the cluster actually came up.

## Machine-readable releases

- [Latest stable pointer](https://rasputin.geekdojo.com/releases.json): versions + image download URLs, regenerated daily and on every release.
- [OS release manifest](https://github.com/geekdojo/rasputin-os/releases/latest/download/manifest.json): authoritative — per-artifact SHA-256 checksums, sizes, signer.
- [Firewall release manifest](https://github.com/geekdojo/rasputin-openwrt-firewall/releases/latest/download/manifest.json): same, for the firewall image.
- [Rasputin root CA](https://rasputin.geekdojo.com/rasputin-root-ca.pem): public trust anchor for release signatures (verify commands in the agents doc).

## Install

- One command (macOS/Linux): `curl -fsSL https://rasputin.geekdojo.com/bootstrap.sh | sudo bash`
- [bootstrap.sh](https://rasputin.geekdojo.com/bootstrap.sh): fully scriptable — non-interactive via `RASPUTIN_*` env vars (`RASPUTIN_DRY_RUN=1` for a no-write preflight); see the agents doc above.
- [Download page](https://rasputin.geekdojo.com/download/): images, manual flashing steps, verification.

## Source

- [GitHub](https://github.com/geekdojo): rasputin-os, rasputin-control-plane, rasputin-openwrt-firewall, rasputin-site.
- [Architecture](https://github.com/geekdojo/rasputin-control-plane/blob/main/ARCHITECTURE.md): node roles, the bus, the job model, updates.
- [Devlog](https://rasputin.geekdojo.com/devlog/): what shipped, weekly-ish.