History

Ezequiel C. 187379de4e multistreaming: scenes/composition, installer build support, service updates - multistreaming (new): RTMP ingest + multi-platform fan-out with pluggable providers (Twitch/YouTube/Kick/custom), zero-knowledge key vaults, Authelia OIDC auth, shared rooms with editor/streamer roles, single-use invites, per-account streaming grants, and scenes & composition (grid/PiP layouts, text/image overlays, per-output audio routing). - installer: support Dockerfile build in metadata (not just image) and RSA key generation for the Authelia OIDC JWKS. - authelia: add OIDC provider with portainer + multistreaming clients (public + PKCE). - services: remove allprox; add nginx-proxy-manager and portainer; update lldap; regenerate catalog.		2026-09-02 21:18:25 +02:00
..
scripts	Add homelab installer and services (allprox, authelia, lldap)	2026-09-01 18:32:56 +02:00
src	multistreaming: scenes/composition, installer build support, service updates	2026-09-02 21:18:25 +02:00
.gitignore	Add homelab installer and services (allprox, authelia, lldap)	2026-09-01 18:32:56 +02:00
bun.lock	Add homelab installer and services (allprox, authelia, lldap)	2026-09-01 18:32:56 +02:00
package.json	Add homelab installer and services (allprox, authelia, lldap)	2026-09-01 18:32:56 +02:00
README.md	Add homelab installer and services (allprox, authelia, lldap)	2026-09-01 18:32:56 +02:00
tsconfig.json	Add homelab installer and services (allprox, authelia, lldap)	2026-09-01 18:32:56 +02:00

README.md

homelab installer

A terminal UI (and CLI) written in TypeScript for Bun that installs and updates homelab services from this repository's GitHub-hosted catalog.

Install

cd installer
bun install

Run

bun run src/index.ts          # interactive TUI
bun run src/index.ts list     # list the catalog
bun run src/index.ts install portainer
bun run src/index.ts update
bun run src/index.ts uninstall portainer
bun run src/index.ts status
bun run src/index.ts info pihole

Run bun run src/index.ts --help for the full flag reference.

Layout

installer/
├── package.json
├── tsconfig.json
├── src/
│   ├── index.ts      # entry point + CLI argument parsing
│   ├── tui.ts        # interactive menu (powered by @clack/prompts)
│   ├── commands.ts   # install/update/uninstall/list/status/info actions
│   ├── github.ts     # GitHub CDN: catalog listing + raw metadata fetch
│   ├── metadata.ts   # metadata parsing + validation
│   ├── compose.ts    # docker-compose.yml generation from metadata
│   ├── env.ts        # env var resolution + .env read/write
│   ├── docker.ts     # `docker compose` runner
│   ├── state.ts      # installed-state persistence (~/.homelab/state.json)
│   ├── paths.ts      # config/data directory helpers
│   ├── prompts.ts    # @clack prompt wrappers
│   ├── config.ts     # source configuration (owner/repo/branch/local)
│   └── util.ts       # colors + table printer
└── scripts/
    └── generate-catalog.ts  # regenerate services/catalog.json

How it works

List — fetch services/catalog.json from GitHub (falling back to the git/trees API).
Fetch — download each selected metadata.json from raw.githubusercontent.com.
Resolve env — prompt for declared variables (or use defaults / --env values).
Generate — write ~/.homelab/services/<id>/docker-compose.yml + .env.
Deploy — run docker compose up -d (or pull + up -d for updates).
Record — persist the installed version in ~/.homelab/state.json.

Set HOMELAB_HOME to relocate ~/.homelab. For a private GitHub repository, set HOMELAB_GITHUB_TOKEN (or GITHUB_TOKEN / HOMELAB_TOKEN) to a personal access token so the installer can read the catalog and metadata.

Developing services locally

Point the installer at your checkout while you write a new metadata.json:

bun run src/index.ts list --local ../services
bun run src/index.ts install my-service --local ../services --dry-run

--dry-run prints the generated docker-compose.yml without running Docker.