Skip to content
besoeasyPublic

Repository files navigation

yantr

⚡ Yantr

One command, and you're self-hosting.

Run apps on your Linux. Keep your Linux.

Rootless · No sudo · No account · Corporate-free

Jellyfin · Nextcloud · Ollama · Pi-hole · n8n · +170 more

curl -fsSL https://yantr.org/install.sh | bash

Podman Rootless Daemonless Go License Vue 3 Website

Star History Rank

Why Podman? · Quick Start · Community · yantr.org · Report a Bug


An app, not an OS. Umbrel wants your whole machine. Docker wants your root. Yantr takes neither — it installs as your user, runs everything in rootless Podman, and the installer prints every step it takes on your host, timed: receipts, not promises.

The Problem with Umbrel & Friends

Platforms like Umbrel want to be your OS. Dedicate a machine, surrender the environment, live by their rules.

Yantr is an app, not an OS. It runs as a single rootless container on the machine you already have — laptop, Raspberry Pi, old PC, home server. Your host stays untouched. Your files stay put. Yantr manages rootless Podman stacks alongside everything else.

┌──────────────────────────────────────────┐
│            Your Operating System         │
│                                          │
│  ┌──────────────┐   ┌─────────────────┐  │
│  │    Yantr     │   │   Your existing │  │
│  │  (container) │   │   apps & files  │  │
│  └──────┬───────┘   └─────────────────┘  │
│         │ Podman user socket             │
│  ┌──────▼────────────────────────────┐   │
│  │  Jellyfin · n8n · Nextcloud · …   │   │
│  │      (isolated Podman stacks)     │   │
│  └───────────────────────────────────┘   │
└──────────────────────────────────────────┘

🛡️ Rootless by Design: No Sudo, No Daemon, No Host Changes

Most homelab platforms and container managers rely on Docker running as a root-level daemon. While popular, Docker's monolithic architecture introduces critical security vulnerabilities, host filesystem modifications, and single-point-of-failure risks.

Yantr was built from day one to run 100% rootless on Podman. Here is how they compare:

Feature / Metric Traditional Docker Yantr + Rootless Podman
Daemon Privilege Runs as root (dockerd background daemon) Rootless — runs in user namespaces with an unprivileged UID
Security Blast Radius docker group = passwordless root on host (docker run -v /:/host) True isolation — container breakout cannot compromise host root
Engine Architecture Monolithic background daemon (single point of failure) Daemonless — fork/exec model (conmon); no daemon to crash and kill apps
System Service Manager Proprietary daemon supervision Native systemd Quadlet (systemctl --user, auto-starts on boot)
Logging & Monitoring Custom Docker logging drivers Native journalctl --user and Linux cgroups v2 resource accounting
Host Firewall Impact Modifies root iptables/nftables directly (silently bypasses UFW) Zero host firewall tampering — isolated user network (pasta/slirp4netns)
Host Filesystem Footprint Pollutes root /var/lib/docker (requires sudo for maintenance) 100% user space (~/.local/share/containers/) with SELinux :z isolation
Idle Memory Overhead Always-on background daemon consuming RAM & CPU 24/7 Zero daemon overhead — only your running apps consume resources
Docker Socket Safety Exposing /var/run/docker.sock gives complete host root takeover Safe user socket translation — apps get Docker API without host root

🚀 Quick Start

One-line installation on Linux (automatically configures rootless Podman and systemd Quadlet):

curl -fsSL https://cdn.jsdelivr.net/gh/besoeasy/yantr@latest/install.sh | bash

Removing Yantr is the same one-liner with --uninstall. Install, update, repair, uninstall — one script, and every step prints itself with a timer as it runs.

Resolves @latest to the newest tagged release via jsDelivr (never main). The script is also in the repo root as install.sh.

Fedora Debian Ubuntu Arch openSUSE

Detects your package manager (dnf, apt, pacman, zypper), sets up rootless Podman + systemd Quadlet. Any Linux with Podman + systemd works via the manual command below (Alpine excluded — no systemd Quadlet).

Image on GHCR (besoeasy/yantr):

podman pull ghcr.io/besoeasy/yantr:latest

Multi-arch (amd64/arm64), cosign-signed. :dev tracks main.

Run as your normal user — never sudo. Rootless-only by design; the installer refuses root.

Or run manually with rootless Podman:

podman run -d \
  --name yantr \
  --network host \
  --security-opt label=disable \
  -e HOST_PODMAN_SOCKET=${XDG_RUNTIME_DIR:-/run/user/$(id -u)}/podman/podman.sock \
  -v ${XDG_RUNTIME_DIR:-/run/user/$(id -u)}/podman/podman.sock:/run/podman/podman.sock \
  -v yantr_data:/data:z \
  -v /:/host:ro \
  -v /sys:/sys:ro \
  ghcr.io/besoeasy/yantr:latest
  • HOST_PODMAN_SOCKET — host path to the Podman socket handed to apps mounting /var/run/docker.sock (Portainer, Homarr, Glances). Without it Yantr queries the API at runtime and socket-needing apps may fail to deploy.
  • /host and /sys (read-only) — back the host dashboard's filesystem-usage and temperature tiles. CPU, memory, load, uptime, disk I/O and network come from /proc and need no mount. Skip the binds and those two tiles just report unavailable.

Open http://localhost:5252 and create your operator account on first visit.


💬 Community

Issues and bug reports belong on GitHub so they stay searchable and trackable — that is where they get fixed.

  • App requests — vote and discuss what lands in the catalog next.
  • Troubleshooting — paste logs, and open a report that already says which version ran and on what host.
  • Show and tell — what you're self-hosting.

Star History

Star History Chart

License

Yantr is source-available under the PolyForm Noncommercial License 1.0.0.

  • Personal, hobby, and homelab use: yes
  • Study, change, and share the source under the same terms: yes
  • Schools, charities, and other noncommercial orgs: yes
  • Commercial use (sell it, host it as a paid product, run a business on it): no

The source stays public. The short version is at the top of LICENSE.


Vue 3 · Go · Podman · Custom CSS

yantr.org · Issues · App Format Guide

Releases

Sponsor this project

Packages

Contributors

Languages