Getting Started

Welcome to the Usenet Media Stack! This guide will get you up and running in minutes.

Interactive CLI Demo

Try our commands directly in this interactive terminal simulator:

Quick Start (generic Docker host)

git clone https://github.com/Aristoddle/usenet-media-stack.git
cd usenet-media-stack
cp .env.example .env   # fill provider/API keys
docker compose up -d         # after Docker is installed

Bazzite / Podman-first

• Use Komga on Podman (already running) while transfers finish.
• After reboot (when ready): enable Docker, then docker compose up -d plus optional -f docker-compose.reading.yml for Audiobookshelf.

What You Get

• A working subset of the media stack (see docs/services.md for the live count)
• Hot-swappable JBOD drive support
• Hardware-optimized transcoding
• Tailscale Serve remote access via private tailnet HTTPS

Next Steps

• Installation Guide
• First Deployment
• Reading Stack
• Usenet Primer
• Usenet Onboarding