# self-host

> One Go binary that installs, signs in, wires together and repairs self-hosted Apps with Docker Compose, for people through a terminal Dashboard and for agents through plain commands with --json.

Install on Linux, macOS or WSL with Docker and the Compose v2 plugin:

    curl -fsSL https://self-host.fyi/install | bash

Agents: run `self-host skill` and follow the guide it prints. Every change follows inspect, plan, approval, apply, verify; loading the skill is intent, never approval. Ask the person before any install, remove or restore, then pass --yes.

## Docs

- [README](https://github.com/ajnart/self-host/blob/main/README.md): install, quick start, Links, commands, Access, Backup
- [Agent skill](https://github.com/ajnart/self-host/blob/main/skills/self-host/SKILL.md): the discoverable skill, a router to `self-host skill`
- [Catalog JSON](https://self-host.fyi/catalog.json): every App and Recipe, with ports, images and Links
- [Releases](https://github.com/ajnart/self-host/releases): CLI archives and checksums.txt
- [Discord](https://discord.gg/aCsmEV5RgA): community and help

## Commands

- `self-host doctor --json`: check Docker, ports and the machine
- `self-host apps list --json`, `self-host apps info <app> --json`: browse the Catalog
- `self-host install <app|recipe> --yes --json`: install after approval
- `self-host status --json`: Apps, Addresses and Setup state
- `self-host debug <app>`: failed steps, hints and masked logs

## Recipes

- `media` (Media): Watch your movies and shows, and have new ones requested and downloaded for you. Apps: qbittorrent, sonarr, radarr, prowlarr, jellyfin, seerr
- `audio-library` (Audiobooks and music): Listen to your audiobooks and music on your phone or computer. Apps: audiobookshelf, navidrome
- `backups` (Backups and restore): Back up your important files safely, and check you can get them back. Apps: restic
- `dns` (DNS and network filtering): Block ads across your whole home network, with a backup in case one stops. Apps: unbound, adguard-home
- `documents` (Documents, PDF, and OCR): Scan paper into a searchable archive, and edit PDFs without uploading them. Apps: paperless-ngx, stirling-pdf
- `download-privacy` (Downloader privacy): Download torrents through a VPN, and stop if the VPN drops. Apps: gluetun, qbittorrent
- `files` (Files and synchronization): Your own cloud drive, replacing Google Drive, OneDrive and Dropbox. Apps: nextcloud
- `full` (Full private home server): Everything for a household: movies, photos, files, music, passwords and smart home. Apps: qbittorrent, prowlarr, sonarr, radarr, jellyfin, seerr, immich, nextcloud, navidrome, audiobookshelf, vaultwarden, home-assistant
- `home-automation` (Home automation): Automate your smart home, with cameras that spot people and cars. Apps: home-assistant, node-red, frigate
- `local-ai` (Local AI): Chat with AI on your own computer, so your questions stay private. Apps: ollama, open-webui, beszel
- `monitoring` (Monitoring and observability): Watch your computers and apps and get alerts when something goes wrong. Apps: prometheus, loki, beszel, uptime-kuma, grafana
- `owned-video-library` (Owned movie and TV library): Stream the movies and shows you already own to every screen. Apps: jellyfin
- `passwords` (Passwords): Set up a password manager for the whole household. Apps: vaultwarden
- `personal-finance` (Personal finance): Track your spending and budget privately. Apps: actual-budget
- `personal-media` (Personal media): Watch movies and shows, with downloads, subtitles and requests handled for you. Apps: qbittorrent, gluetun, sonarr, radarr, prowlarr, bazarr, jellyfin, seerr
- `photos` (Photos and mobile backup): Back up your family photos automatically from every phone. Apps: immich
- `photos-and-files` (Photos and cloud files): Back up your photos and keep your files in sync, replacing cloud drives. Apps: immich, nextcloud
- `private-notes` (Private notes and knowledge): A private place for your family or team to write and share notes. Apps: docmost
- `remote-access` (Remote access): Reach your apps from outside your home, privately or through your own web address. Apps: tailscale, cloudflare-tunnel, caddy

## Apps

- [`ollama`](https://self-host.fyi/apps/ollama) (Ollama, Local AI): Run AI chat models on your own computer, with nothing sent to the cloud
- [`open-webui`](https://self-host.fyi/apps/open-webui) (Open WebUI, Local AI): Chat with AI models running on your own computer, in your browser
- [`immich`](https://self-host.fyi/apps/immich) (Immich, Photos): Back up your phone's photos and find any of them by searching
- [`stirling-pdf`](https://self-host.fyi/apps/stirling-pdf) (Stirling PDF, Documents): Edit, merge, convert and sign PDF files without uploading them anywhere
- [`uptime-kuma`](https://self-host.fyi/apps/uptime-kuma) (Uptime Kuma, Monitoring): Get an alert when one of your websites or apps stops working
- [`home-assistant`](https://self-host.fyi/apps/home-assistant) (Home Assistant, Home automation): Control and automate your lights, sensors and smart home devices
- [`syncthing`](https://self-host.fyi/apps/syncthing) (Syncthing, Files): Keep folders identical across your devices, with no cloud in between
- [`netdata`](https://self-host.fyi/apps/netdata) (Netdata, Monitoring): Watch local monitoring data and active alerts
- [`caddy`](https://self-host.fyi/apps/caddy) (Caddy, Ingress): Give your apps their own web addresses, with the secure padlock set up for you
- [`grafana`](https://self-host.fyi/apps/grafana) (Grafana, Observability): Turn numbers about your computers and apps into charts and alerts
- [`vaultwarden`](https://self-host.fyi/apps/vaultwarden) (Vaultwarden, Passwords): Keep all your passwords in one safe place, on every device
- [`prometheus`](https://self-host.fyi/apps/prometheus) (Prometheus, Observability): Record numbers about how your computers and apps are doing over time
- [`traefik`](https://self-host.fyi/apps/traefik) (Traefik, Ingress): Send web visitors to the right app automatically, with a read-only status page
- [`minio`](https://self-host.fyi/apps/minio) (MinIO AIStor, Storage): Store files for your apps and backups, like your own private cloud drive
- [`pihole`](https://self-host.fyi/apps/pihole) (Pi-hole, DNS): Stop ads and trackers on all your devices at home, with a simple admin page
- [`jellyfin`](https://self-host.fyi/apps/jellyfin) (Jellyfin, Media): Stream your movies and shows to every screen in the house
- [`paperless-ngx`](https://self-host.fyi/apps/paperless-ngx) (Paperless-ngx, Documents): Scan paper and files into a searchable, tagged filing cabinet
- [`headscale`](https://self-host.fyi/apps/headscale) (Headscale, Remote access): Connect your devices into one private network, without a Tailscale account
- [`aria2`](https://self-host.fyi/apps/aria2) (Aria2, Downloads): Download files and torrents in the background, controlled by other tools
- [`qbittorrent`](https://self-host.fyi/apps/qbittorrent) (qBittorrent, Downloads): Download and share torrents from a clean web page
- [`photoprism`](https://self-host.fyi/apps/photoprism) (PhotoPrism, Photos): Browse, organize and search your photo collection privately
- [`umami`](https://self-host.fyi/apps/umami) (Umami, Analytics): See how many people visit your websites, without tracking them
- [`portainer`](https://self-host.fyi/apps/portainer) (Portainer, Containers): See and manage your running apps from one web page
- [`tailscale`](https://self-host.fyi/apps/tailscale) (Tailscale, Remote access): Reach your home apps privately from anywhere, on any of your devices
- [`adguard-home`](https://self-host.fyi/apps/adguard-home) (AdGuard Home, DNS): Block ads and trackers on every device at home, with a simple control page
- [`keycloak`](https://self-host.fyi/apps/keycloak) (Keycloak, Identity): Manage logins in one place, so people sign in once to reach many apps
- [`nextcloud`](https://self-host.fyi/apps/nextcloud) (Nextcloud, Files): Keep your files, calendars and contacts in sync across your devices
- [`frigate`](https://self-host.fyi/apps/frigate) (Frigate, Cameras): Record your security cameras and get alerts when people or cars appear
- [`restic`](https://self-host.fyi/apps/restic) (restic, Backups): Back up your files with encryption, and restore them when you need them
- [`ntfy`](https://self-host.fyi/apps/ntfy) (ntfy, Communication): Get instant pop-up alerts on your phone from your apps and scripts
- [`nginx-proxy-manager`](https://self-host.fyi/apps/nginx-proxy-manager) (Nginx Proxy Manager, Ingress): Give your apps easy web addresses and secure padlocks from a web page
- [`glances`](https://self-host.fyi/apps/glances) (Glances, Monitoring): See the workload visible to Glances without extra access to your computer
- [`netbird`](https://self-host.fyi/apps/netbird) (NetBird, Remote access): Connect your devices into one private network, wherever they are
- [`actual-budget`](https://self-host.fyi/apps/actual-budget) (Actual Budget, Productivity): Plan your spending and follow every dollar, with one budget on all your devices
- [`authelia`](https://self-host.fyi/apps/authelia) (Authelia, Identity): Add a login page with a second security step in front of your other apps
- [`loki`](https://self-host.fyi/apps/loki) (Loki, Observability): Gather your apps' activity messages in one place to search through
- [`valkey`](https://self-host.fyi/apps/valkey) (Valkey, Databases): A fast short-term memory that your other apps use to run quicker
- [`beszel`](https://self-host.fyi/apps/beszel) (Beszel, Monitoring): See how busy your computers are: processor, memory and disk space
- [`authentik`](https://self-host.fyi/apps/authentik) (Authentik, Identity): Sign in once to reach all your apps, with one login for the whole household
- [`homebridge`](https://self-host.fyi/apps/homebridge) (Homebridge, Home automation): Make smart home gadgets work with Apple Home
- [`firefly-iii`](https://self-host.fyi/apps/firefly-iii) (Firefly III, Productivity): Track your income, expenses and budgets in one private place
- [`dockge`](https://self-host.fyi/apps/dockge) (Dockge, Containers): Start, stop and edit your apps from a simple web page
- [`navidrome`](https://self-host.fyi/apps/navidrome) (Navidrome, Media): Stream your music collection to your phone or computer
- [`node-red`](https://self-host.fyi/apps/node-red) (Node-RED, Home automation): Connect devices and services with simple drag-and-drop automations
- [`pangolin`](https://self-host.fyi/apps/pangolin) (Pangolin, Remote access): Reach your apps from outside your home by name, behind a login page
- [`renovate`](https://self-host.fyi/apps/renovate) (Renovate, Developer tools): Automatically suggest updates for the software your code projects depend on
- [`vector`](https://self-host.fyi/apps/vector) (Vector, Observability): Collect your apps' activity messages and send them where you choose
- [`postgresql`](https://self-host.fyi/apps/postgresql) (PostgreSQL, Databases): A database where your other apps keep their information
- [`docmost`](https://self-host.fyi/apps/docmost) (Docmost, Productivity): Write and share notes and documents with your family or team
- [`linkwarden`](https://self-host.fyi/apps/linkwarden) (Linkwarden, Productivity): Save web pages you care about and search them later
- [`bookstack`](https://self-host.fyi/apps/bookstack) (BookStack, Productivity): Keep notes and how-to guides organized in books, chapters and pages
- [`victoria-metrics`](https://self-host.fyi/apps/victoria-metrics) (VictoriaMetrics, Observability): Keep long histories of numbers about your computers and apps, stored compactly
- [`zerotier`](https://self-host.fyi/apps/zerotier) (ZeroTier, Remote access): Connect your devices into one private network, as if on the same Wi-Fi
- [`sonarr`](https://self-host.fyi/apps/sonarr) (Sonarr, Requests): Find, download and organize TV shows automatically. Links to qbittorrent
- [`freshrss`](https://self-host.fyi/apps/freshrss) (FreshRSS, Productivity): Read news from all your favorite websites in one place
- [`cloudflare-tunnel`](https://self-host.fyi/apps/cloudflare-tunnel) (Cloudflare Tunnel, Remote access): Open your app to the internet safely through Cloudflare, with no router changes
- [`gotify`](https://self-host.fyi/apps/gotify) (Gotify, Communication): Collect notifications from your apps and send them to your phone
- [`gluetun`](https://self-host.fyi/apps/gluetun) (Gluetun, Downloads): Send your downloads through a VPN, and stop them if it disconnects
- [`seafile`](https://self-host.fyi/apps/seafile) (Seafile, Files): Sync and share your files across all your devices
- [`transmission`](https://self-host.fyi/apps/transmission) (Transmission, Downloads): Download torrents in the background, light on your computer's resources
- [`stalwart-mail`](https://self-host.fyi/apps/stalwart-mail) (Stalwart Mail Server, Communication): Run your own email service, managed from a private admin page
- [`audiobookshelf`](https://self-host.fyi/apps/audiobookshelf) (Audiobookshelf, Media): Listen to your audiobooks and podcasts on your phone or in a browser
- [`radarr`](https://self-host.fyi/apps/radarr) (Radarr, Requests): Find, download and organize movies automatically. Links to qbittorrent
- [`kopia`](https://self-host.fyi/apps/kopia) (Kopia, Backups): Back up your files with encryption and check on them from a web page
- [`seerr`](https://self-host.fyi/apps/seerr) (Seerr, Requests): Let your family ask for movies and shows to be added. Links to jellyfin, sonarr, radarr
- [`gatus`](https://self-host.fyi/apps/gatus) (Gatus, Monitoring): Check that your apps are working and see them on a status page
- [`technitium-dns`](https://self-host.fyi/apps/technitium-dns) (Technitium DNS Server, DNS): Run your home network's address book (DNS), blocking ads and unwanted sites
- [`prowlarr`](https://self-host.fyi/apps/prowlarr) (Prowlarr, Requests): Manage the search sites that Sonarr and Radarr use to find your downloads. Links to sonarr, radarr
- [`haproxy`](https://self-host.fyi/apps/haproxy) (HAProxy, Ingress): Give your apps one shared front door, with a page of usage statistics
- [`lldap`](https://self-host.fyi/apps/lldap) (LLDAP, Identity): Keep one list of users and passwords that your apps can share
- [`passbolt`](https://self-host.fyi/apps/passbolt) (Passbolt, Passwords): Share passwords safely with your team, with a browser add-on
- [`speedtest-tracker`](https://self-host.fyi/apps/speedtest-tracker) (Speedtest Tracker, Monitoring): Check your internet speed on a schedule and keep the history
- [`scrypted`](https://self-host.fyi/apps/scrypted) (Scrypted, Cameras): Bring your security cameras into Apple Home and other smart home apps
- [`lidarr`](https://self-host.fyi/apps/lidarr) (Lidarr, Requests): Find, download and organize your music automatically
- [`homarr`](https://self-host.fyi/apps/homarr) (Homarr, Dashboard): Put all your apps on one home page, each a click away. Links to sonarr, radarr, prowlarr, jellyfin, seerr, qbittorrent, beszel, ntfy, vaultwarden, immich, caddy, gatus, prometheus, gotify, technitium-dns, dashdot, glances, netdata, traefik, audiobookshelf, paperless-ngx, linkwarden, nextcloud, lidarr, emby, pihole, uptime-kuma, aria2, bazarr, archive-team-warrior, umami, speedtest-tracker, deluge, transmission, adguard-home, navidrome, nzbget, sabnzbd, gluetun, plex, frigate, home-assistant, peanut, tdarr, tracearr, slskd, wud, patchmon
- [`emby`](https://self-host.fyi/apps/emby) (Emby, Media): Watch your own movies and shows on any TV, phone or computer
- [`unbound`](https://self-host.fyi/apps/unbound) (Unbound, DNS): Look up website addresses for your whole network, privately and quickly
- [`bazarr`](https://self-host.fyi/apps/bazarr) (Bazarr, Requests): Automatically find subtitles for your movies and shows
- [`tdarr`](https://self-host.fyi/apps/tdarr) (Tdarr, Media): Shrink and convert your video files automatically to save space
- [`slskd`](https://self-host.fyi/apps/slskd) (Slskd, Downloads): Share and find music with others on the Soulseek network, from a web page
- [`wud`](https://self-host.fyi/apps/wud) (What's Up Docker, Containers): Tell you when new versions of your apps are available
- [`dashdot`](https://self-host.fyi/apps/dashdot) (Dash., Monitoring): See kernel-visible processor and memory use
- [`patchmon`](https://self-host.fyi/apps/patchmon) (PatchMon, Monitoring): See which of your computers are waiting for software updates
- [`sabnzbd`](https://self-host.fyi/apps/sabnzbd) (SABnzbd, Downloads): Automatically fetch files from Usenet, a paid file-sharing service
- [`tracearr`](https://self-host.fyi/apps/tracearr) (Tracearr, Media): See who watches what on your media server, and when
- [`borgmatic`](https://self-host.fyi/apps/borgmatic) (Borgmatic, Backups): Back up your files on a schedule, safely encrypted
- [`deluge`](https://self-host.fyi/apps/deluge) (Deluge, Downloads): Download torrents in the background, with a simple web page to manage them
- [`peanut`](https://self-host.fyi/apps/peanut) (PeaNUT, Monitoring): Check on your battery backup (UPS) with a live dashboard
- [`mayan-edms`](https://self-host.fyi/apps/mayan-edms) (Mayan EDMS, Documents): Store scanned paper documents, make them searchable and route them for review
- [`nzbget`](https://self-host.fyi/apps/nzbget) (NZBGet, Downloads): Download files from your Usenet provider, a paid file-sharing service
- [`archive-team-warrior`](https://self-host.fyi/apps/archive-team-warrior) (ArchiveTeam Warrior, Downloads): Lend your spare internet time to help save websites before they disappear
- [`forgejo`](https://self-host.fyi/apps/forgejo) (Forgejo, Developer tools): Store and track your software code privately, like a private GitHub
- [`plex`](https://self-host.fyi/apps/plex) (Plex, Media): Stream your movies and shows to any TV, phone or tablet, signed in with Plex