TotiOS

Vier Varianten

Eine OS-Basis, vier Gesichter

Von minimal-headless bis zum vollen GNOME-Desktop — jede Variante baut auf der selben Alpine-Linux-Basis und den gleichen Kernservices.

Headless

~128MB RAM / ~500MB

Der minimale Server. Kein Display, kein Desktop, kein Browser. Alpine + TotiOS Core-Services ueber SSH/Mercury.

Mercury Remote
Auto-Updater
Tailscale VPN
Docker

wget -O - https://raw.githubusercontent.com/TitoPrausee/totios/main/install-headless.sh | sh

Console

~180MB RAM / ~750MB

Power-User Terminal. btop, lazydocker, lazygit, neovim, tmux, starship — alles auf der Headless-Basis.

btop System-Monitor
lazydocker + lazygit
neovim + tmux
starship Prompt

wget -O - https://raw.githubusercontent.com/TitoPrausee/totios/main/install-console.sh | sh

GNOME Desktop

~512MB RAM / ~2.5GB

Voller Desktop. GNOME Shell mit Wayland, GDM, Firefox, Nautilus. Pi-Tuning inklusive — gpu_mem, zram, ondemand governor.

GNOME Shell (Wayland)
Firefox + Nautilus
Alle Console-Tools
Pi Performance-Tuning

wget -O - https://raw.githubusercontent.com/TitoPrausee/totios/main/install-gnome.sh | sh

Legacy / Kiosk

~256MB RAM / ~1.2GB

Web-Dashboard auf Port 8080 plus optionales X11-Kiosk. Erhalten fuer bestehende Deployments.

Web Dashboard :8080
Optional X11 Kiosk
Service Management
Docker Management

wget -O - https://raw.githubusercontent.com/TitoPrausee/totios/main/install-ui.sh | sh

Core Features

Was TotiOS anders macht

Sechs Eigenschaften, die TotiOS von einer normalen Alpine-Installation unterscheiden.

01

Native Mercury Remote

Atlas (oder jeder Hermes-Agent) hat vollen Shell-, Datei- und Docker-Zugriff ueber Tailscale VPN via Mercury Relay. Kein Port-Forwarding noetig.

02

Live Self-Improving

Neue Features werden per git push deployiert. Der Pi pullt alle 60 Sekunden und registriert neue Services automatisch als OpenRC-Services.

03

Ultra-Minimal Base

Alpine Linux mit musl libc — ~5MB Basis-System. Maximale Anpassbarkeit, kein Bloat. Nur was du brauchst, laeuft.

04

Full Dev Environment

Python 3, Docker, Git, Rust, Node.js — alles dabei, um direkt auf dem Geraet zu entwickeln. Kein Cross-Compile, kein SDK.

05

Auto-Updater Daemon

totios-updater pullt das Git-Repo, erkennt neue Services in services/ und registriert sie als OpenRC init-Services. Hot-Reload ohne Reboot.

06

Tailscale VPN Built-In

Tailscale ab Werk. Das Geraet verbindet sich automatisch mit dem Tailnet und ist ueber Mercury Relay von ueberall erreichbar.

Architektur

Wie TotiOS funktioniert

Atlas spricht zum Geraet ueber Mercury Relay. Der Pi laeuft komplett autonom — mit Auto-Update, Service-Registry und Docker.

Atlas (Hermes Agent) → Mercury Relay (Mac Mini:8443) → Tailscale VPN → TotiOS (Pi 4/5) │ ┌────────────────────────────────────────────────────┬┘ │ Alpine Linux (musl, ~5MB base) │ │ ├── OpenRC init │ │ │ ├── mercury-remote (Relay Client, phone-home) │ │ │ ├── totios-updater (auto-pull + service reg) │ │ │ ├── tailscaled (VPN) │ │ │ ├── docker (container runtime) │ │ │ └── sshd (fallback access) │ │ ├── /opt/totios/ (git repo — live features) │ │ │ ├── services/ (auto-registered Python services) │ │ │ ├── config/ (system configuration) │ │ │ ├── mercury/ (remote access setup) │ │ │ └── updater/ (auto-update daemon) │ │ └── Dev: Python 3, Docker, Git, Rust, Node.js │ └─────────────────────────────────────────────────────┘

1

Feature schreiben

Atlas schreibt einen Python-Service in services/

2

Git Push

Atlas pusht in das TotiOS-Repo auf GitHub

3

Auto-Pull (60s)

Der Pi pullt das Repo und erkennt neue Services

4

Auto-Register

Neue Services werden als OpenRC init registriert

5

Live verfügbar

Feature ist sofort ueber Mercury Remote nutzbar

Supported Devices

Laeuft auf allem

Von Pi 3 bis x86_64 NUC — TotiOS passt sich dem Geraet an.

Geraet	Arch	Headless	Console	GNOME	Kiosk	X11
Raspberry Pi 5	aarch64	✓	✓	✓	✓	✓
Raspberry Pi 4	aarch64	✓	✓	✓ (2GB+)	✓	✓
Raspberry Pi 3	armv7l	✓	✓	—	✓	~
Generic ARM64 SBC	aarch64	✓	✓	✓ (2GB+)	✓	✓
x86_64 (NUC, mini PC)	x86_64	✓	✓	✓	✓	✓
Alpine VM (QEMU)	x86_64/a64	✓	✓	✓ (GPU)	✓	—

Feature Matrix

Varianten im Direktvergleich

Feature	Headless	Console	GNOME	Kiosk
Web Dashboard	—	—	—	✓
TUI Tools (btop etc.)	—	✓	✓	—
GNOME Shell	—	—	✓	—
Firefox Browser	—	—	✓	—
X11 Display	—	—	✓	✓ (opt.)
Performance Tweaks	—	—	✓	—
Docker Management	✓ CLI	✓ CLI+TUI	✓ CLI+TUI	✓ Web+CLI
Mercury Remote	✓	✓	✓	✓
Auto-Updater	✓	✓	✓	✓
Tailscale VPN	✓	✓	✓	✓
RAM (idle)	~128MB	~180MB	~512MB	~256MB
Install Size	~500MB	~750MB	~2.5GB	~1.2GB

Quick Start

In einer Zeile installiert

Auf jedem Alpine-Linux-Geraet ausfuehren. Waehle die Variante oder lass den interaktiven Installer entscheiden.

headless.sh
# Minimal — kein UI
wget -O - https://raw.githubusercontent.com/TitoPrausee/totios/main/install-headless.sh | sh

console.sh
# TUI + CLI Tools
wget -O - https://raw.githubusercontent.com/TitoPrausee/totios/main/install-console.sh | sh

gnome.sh
# Full Desktop
wget -O - https://raw.githubusercontent.com/TitoPrausee/totios/main/install-gnome.sh | sh

install.sh (interactive)
# Waehle zur Laufzeit
wget -O - https://raw.githubusercontent.com/TitoPrausee/totios/main/install.sh | sh

# Nach der Installation:
tailscale up --reset --accept-routes --ssh --hostname=totios
reboot

Live Development

Feature hinzufuegen in 60 Sekunden

Ein Python-Service in services/ ablegen, git push — der Pi macht den Rest.

services/my-feature/service.json
{
  "name": "my-feature",
  "description": "What this service does",
  "version": "1.0.0",
  "port": 8080,
  "autorun": true
}

# Push to git → Pi auto-pulls within 60s → service registered

Download

USB-Stick oder SD-Karte flashen

Lade den TotiOS Installer fuer dein Betriebssystem herunter. USB-Stick oder SD-Karte einstecken, Installer ausfuehren — fertig.

macOS (.dmg) Windows (.exe) Linux (binary)

oder als Python-Skript ausfuehren (Advanced)

Installer herunterladen
# macOS / Linux:
curl -O https://mercury-og.tailaa8f66.ts.net/totios/downloads/totios-installer.py

# Windows (PowerShell):
Invoke-WebRequest https://mercury-og.tailaa8f66.ts.net/totios/downloads/totios-installer.py

Installer ausfuehren
# USB-Stick / SD-Karte einstecken, dann:
python3 totios-installer.py

# Non-interactive:
python3 totios-installer.py --variant headless --arch aarch64 --device /dev/sdX --yes

Python-Skript herunterladen

Image-Katalog ansehen

oder direkt ein Image herunterladen

Lade Katalog...