ryra 0.1.1

A tool to test and deploy self-hosted services on a Linux server using rootless Podman and systemd. Built-in VM testing gives AI agents fast feedback loops for building infrastructure and deploying apps.
ryra-0.1.1 is not a library.

Ryra

License: AGPL v3 CI

Self-host anything, automatically test it works.

Ryra scaffolds rootless, daemonless podman containers wired with the same authorization system (SSO) and e-mail system with SMTP. The bundled registry covers useful services, each end-to-end tested in a fresh virtual machine, and the test framework is simple enough that you can have an AI add new services and prove they work the same way.

Website · Docs · Services

Install

curl -fsSL https://ryra.dev/install.sh | sh

Or with Rust:

cargo install ryra

Works on Debian, Ubuntu, Fedora, Arch, and any Linux with systemd and Podman.

Quickstart

ryra search           # browse the registry
ryra add <service>    # install one

What it does

ryra add <service> reads a recipe from a curated registry and writes:

  • A rootless Podman container, owned by your user
  • A systemd quadlet, so systemctl --user and journalctl --user work like normal
  • Optionally: a Caddy route with auto-HTTPS, and an Authelia OIDC client for SSO

Service data lives at ~/.local/share/services/<name>/. Back it up with tar. Uninstall ryra and your stack keeps running, because the systemd units and containers stay.

Why

SaaS prices keep climbing and the products keep moving slower than you want. Self-hosting is the way out, but the operational cost (compose files, reverse proxies, expiring certs, half-finished install scripts) is what stops most people from leaving.

No other self-hosting toolkit ships the full combination: rootless podman quadlets for security and clean systemd integration, automated VM tests that prove every registry service works before you install it, and a TOML-based recipe format that an AI can read and extend without hand-holding. You stay in control: customise per host, add your own services, and grow your stack at the pace your vendors won't.

Examples

Replace your cloud storage

ryra add seafile

Replace your todo list

ryra add vikunja

Run your own AI gateway

ryra add openclaw

Install anything

The registry is plain TOML and quadlet files. Drop a definition in for your own app, point ryra at your registry, and install it the same way as anything bundled.

Services

Run ryra search for the full list, or browse the services catalog. The bundled registry includes Immich, Forgejo, Vaultwarden, Nextcloud, Twenty CRM, Paperless-ngx, Synapse, Supabase, Open WebUI, Authelia, Uptime Kuma, Caddy, DocuSeal, Zammad, Seafile, Vikunja, OpenClaw, and more.

Documentation

Full docs at ryra.dev/intro.

License

AGPL-3.0-or-later. See LICENCE.md.