Your first stack

With the binary on your PATH and Docker running, type one word:

$ lemonfiber

On a machine with nothing configured, that offers first-time setup. It is not hidden behind a subcommand you would have to know to look for. If you would rather be explicit, lemonfiber setup does the same thing.

What setup asks, and why

A question is only asked if lemonfiber cannot work the answer out for itself, the answer changes what happens, and you can plausibly answer it. That is why your timezone is detected and confirmed rather than asked, and why the container user is only asked where file ownership is genuinely visible.

Step	What happens
Welcome	States what is about to happen and roughly how long it will take.
Preflight	Detects your operating system, checks Docker is present and its daemon reachable, and checks Compose is new enough.
Protocols	Usenet, torrents, both, or neither.
Prerequisites	The account checklist, derived from what you just chose. Nothing is shown for a protocol you declined.
Data location	Proposes a default, then creates a hardlink there and inspects it.
Credentials	Each one tested against the live service as you enter it.
Quality	In plain language — see Quality presets.
Library	Whether to run Jellyfin, and how.
Household	Whether other people in the home will use it.
Autostart	Whether the stack should start when the machine boots.
Review	A complete summary of every value that will be written. Nothing has touched the disk yet.
Apply	Writes the configuration, creates the directories, materialises the stack files.
Start	Pulls the images with per-image progress, then waits for each service to report healthy.
Wire	Connects the services to each other through their own APIs.
Finish	Prints the URLs, and offers to walk one item through the pipeline.

Two things about that table are worth saying plainly.

Nothing is written until you confirm the review. Everything up to that point is read-only, apart from a small progress file. You can abandon setup at any point and leave nothing behind.

It is resumable, not restartable. Quitting mid-way keeps your answers, and the next run picks up at the step you reached. If an apply is interrupted, the next run detects it, tells you exactly what was written, and offers to resume, roll back, or start over.

The zero-cost path

Declining both protocols is a supported answer, not a lesser one. Setup skips the account checklist and the credential steps entirely, and you end up with a working Jellyfin over the media you already have — no subscriptions, no indexers, no spend.

You can add protocols later without redoing any of this.

Running it unattended

Every question has a flag. Given all of them plus --yes, setup runs without a terminal:

$ lemonfiber setup --yes \
    --protocols usenet \
    --data-location /srv/media \
    --usenet-host news.example.net \
    --usenet-user alice \
    --usenet-pass "$USENET_PASS" \
    --indexer-url https://indexer.example.net \
    --indexer-key "$INDEXER_KEY" \
    --library docker \
    --autostart true

A non-interactive run that is missing a flag it needs is told which flag, rather than left waiting on input that will never arrive. --dry-run says what would happen and changes nothing.

The full list of flags is in Every command.

After setup finishes

Setup starts the stack and waits for the services to become healthy, so by the time it returns you have something running. Three things are worth doing next.

Watch one item go through the pipeline.

$ lemonfiber walkthrough

This searches the indexers, grabs a release, downloads it, imports it, and shows it appear in the library — narrating each step as it happens. Name something, or name nothing and be suggested something likely to work. If any link in the chain is broken, this is where it shows, with the step named and a way out. It is the fastest way to end up with a mental model of what your stack actually does.

Check what is running.

$ lemonfiber ps

That reports what each service is really doing, rather than whether a container process exists.

Prove it is doing the right thing.

$ lemonfiber doctor

The doctor runs the checks that turn assumptions into assertions — is the VPN genuinely carrying the torrent traffic, are imports hardlinking, is there disk headroom. See Run the doctor.

Where to go from here

• Forms and slices — starting only the part you need
• The services — what each of the nineteen does
• Words we use — the vocabulary the services assume you have
• J1 First run — the same journey, written as a specification