tycho

Tycho

Tycho is an autonomous server management CLI designed to deploy and manage a complete, self-hosted infrastructure using Podman. It supports two primary deployment patterns.

Key Features

• Standalone CLI: One tool to rule them all.
• Dynamic Recipes: Fetches the latest configurations directly from GitHub.
• Rootless First: Optimized for rootless Podman environments with strict user isolation.
• Automated Storage: Each user gets their own isolated storage space (e.g., /data/users/username/app).
• Smart Routing: Automatic Traefik detection and subdomain conflict checks.

Quick Install

curl -fsSL https://tycho.cc/install.sh | bash

---

🏗 Choose your Architecture

1. Personal Server (Full User Mode)

The easiest way for a single user. Everything (including Traefik) runs in your user space.

• Prerequisite: Allow binding to ports 80/443: echo "net.ipv4.ip_unprivileged_port_start=0" | sudo tee /etc/sysctl.d/99-rootless.conf && sudo sysctl --system
• Workflow:

  tycho setup
  tycho install traefik    # Installs core/traefik in your home
  tycho install core/smtp
  tycho install immich     # Or any other recipe
  

2. Infrastructure Server (Shared/System Mode)

More robust. Traefik is a system-level gateway, and users install their apps separately.

• Step A (Admin): Install the system gateway:

  sudo tycho setup
  sudo tycho install traefik  # Creates a systemd service
  

• Step B (Users): Install personal apps:

  tycho setup
  tycho install immich
  

---

Commands

• tycho setup: Interactive assistant to configure your domain and email.
• tycho list: Explore available recipes on GitHub.
• tycho install <pkg>: Deploy a new service (interactive).
• tycho uninstall <pkg>: Cleanly remove a service and its data.
• tycho stats: Monitor your server’s health.
• tycho upgrade: Self-update the CLI to the latest version.

License

GNU AGPL-v3. See LICENSE for details.

This site is open source. Improve this page.