Commands

lemonfiber is one binary with one subcommand at a time. Run it with no subcommand at all on a machine that is already set up and you get the terminal interface instead.

Every subcommand below accepts the same four global flags, and every one of them has a machine-readable form. The tables here say what each command is for; the full generated reference, with every argument and flag, is the complete command reference — generated from the binary at the revision this site pins, which that page names at its foot.

Global flagsThe four flags every subcommand takes, and the ones that only look global.

The terminal interfaceThe dashboard and the log viewer, and every key they answer to.

The complete command referenceGenerated from what the binary parses, at the revision this site pins.

Words we useForm, profile, slice, drift, seed — the vocabulary these commands assume.

Getting started

Command	What it does	Reach for it when
setup	Sets up the stack by answering a few questions	You are starting, or re-answering a question you got wrong. Interactive by default; the flags make it unattended
migrate	Sees what is already on this machine, and takes it over if you choose to	You already run a media stack of your own and want lemonfiber to stand beside it, in place of it, or to carry its records across
walkthrough	Adds one thing, end to end, and narrates every step	You want to watch the stack work once, so you know what it does because you saw it do it
version	Reports the versions in play	You need the binary, stack, manifest schema and Compose versions in one place

Running the stack

Command	What it does	Reach for it when
forms	Lists the forms this stack has, and what each one is for	You want to know what starting something would come to, without starting it
up	Starts a form, or the union of several	You want part or all of the stack running
down	Stops and removes what a form started	You want it stopped. --wait lets downloads in flight finish first
switch	Makes these forms the active set, leaving shared services running	You are changing shape and do not want a running download interrupted for it
restart	Restarts services without touching the rest	One service is misbehaving and the rest is fine
pull	Fetches newer images without applying them	You want the download done now and the change made later
watch	Guards the data location while forms run, stopping them if it disappears	The library lives on a disk that can go away, and you would rather stop than write to the wrong place
hosting	Says what this machine keeps running when no terminal is open	You want a long-running command to survive the terminal you started it in, and to know whether it really is

Seeing what is happening

Command	What it does	Reach for it when
ps	Reports what each service is actually doing	You want the state of the stack in one screen
logs	Shows what services are saying	You want the lines. --follow keeps reading; --watch opens the scrollable viewer
trace	Follows one show or film across the services	You are asking “where is my show?” and want the answer step by step
household	Shows what the household asked for, and where each request stands	You want the queue grouped by whoever asked for it
stuck	Lists the items whose downloads are stuck	Something reported a count of stuck items and you want them named
front-door	Names the one address to send somebody who lives here	Somebody in the house asks where to go, and you want one answer rather than a list of ports

The household

Command	What it does	Reach for it when
invite	Offers somebody in the house an account they can claim	Somebody new should be able to watch. They set their own password; you never choose or see it
reissue	Lets somebody set a new password, without you choosing or seeing it	They are locked out. The account stays theirs and becomes claimable again
remove	Takes somebody out of the household, in both places they have an account	They are leaving. It says what removing them costs before it removes anything
clients	Says which app to watch on, for each kind of device in the house	Somebody asks what to install, and you want one answer per device rather than a list of everything

The disk and the line

Command	What it does	Reach for it when
space	Accounts for the disk: where the room went, when it runs out, what can go	The disk is filling and you want to know what took it, and what could be got back
stop-seeding	Stops seeding one completed download, and lets its files go with it	You want the room back from one torrent, and to be told what letting it go costs first
bandwidth	Accounts for the line: what it carries, what the stack takes, what that costs	The house is complaining, and you want the stack held to a share of the line rather than all of it

Settings and quality

Command	What it does	Reach for it when
config	Reads or changes one setting, through the three subcommands below	You are reaching for one of the three below
config get	Reads one setting	You want one value
config set	Changes one setting	You want to change one value without opening a file
config show	Shows every setting, with credentials withheld	You want the whole picture and it is safe to look at
alerts	Chooses how much lemonfiber tells you about, in plain language	You are being told too much, or too little, and want to say which
quality	Chooses how good your media should look, in plain language	You are reaching for one of the four below
quality show	Shows the quality choice in force, and what each preset means and costs	You are deciding, and the cost is the thing you are deciding on
quality set	Chooses a preset, for everything or for one media type	You want different quality, from now on
quality reapply	Re-asserts the recorded preset over a hand-edited Recyclarr config	You edited the config, changed your mind, and want the preset to win
quality upgrade	Re-downloads what is already here at the higher quality	You want the back catalogue brought up as well. Large and bandwidth-expensive, so it does nothing until --confirm

Checking and repairing

Command	What it does	Reach for it when
doctor	Runs the checks that prove the stack is doing what it should	Anything is wrong, or nothing is and you want that established rather than assumed. --fix offers repairs one at a time; --undo puts the last one back

Wiring, and your own edits

Command	What it does	Reach for it when
seed	Wires the stack’s services to each other, idempotently	A service has just joined the running set, or you want the wiring re-checked. It never overwrites what you changed
adopt	Adopts your current edits as lemonfiber’s expected state	You are happy with a change you made by hand and want it kept across future seeds and restores
reset	Puts the stack back to lemonfiber’s own state, reverting every edit you made	You want your edits gone. It names what will be lost and does nothing until --confirm

Keeping and sharing your configuration

Command	What it does	Reach for it when
backup	Backs up your configuration to an archive	You are about to change something, or you would rather your configuration stopped being precious
restore	Restores your configuration from a backup archive	You are putting a stack back, here or on another machine. A different data root needs --repoint
support	Gathers what a person helping you would ask for, redacted	You are asking for help. A bare run writes nothing and says what the bundle would hold; --write produces it

What this machine keeps, and what leaves it

Command	What it does	Reach for it when
outbound	Lists everything that leaves this machine, and what refusing each of it costs	You want to know what lemonfiber asks the internet for, what the services ask for on their own account, and what switching each off would stop
stored	Lists what lemonfiber keeps on this machine, where it is, and why	You want to know what is on your disk because of lemonfiber, and to be sure your library is not part of it
credentials	Says which credentials this stack holds, or acts on one of them	You want to know what secrets exist, what each is for and where it stands. Values are never printed by a read
forget	Removes everything lemonfiber keeps on this machine	You are done with it. Your library, your downloads and the containers are never touched; it lists what would go and does nothing until --confirm
uninstall	Takes lemonfiber off this machine, at one of four removals	You are removing it and want to choose how far that goes. It lists what each removal would take before it takes anything

outbound says what would leave. What actually left is written down as it goes, in outbound.log beside your settings: when, which kind of request, where it went, and what came back. Never a header, never a body, and the address arrives with its query stripped off, because a search term, a title or an indexer key ends up there — a record kept to reassure you should not be a file full of your own keys. It holds the last five hundred lines, oldest dropped, and stored lists it with everything else.

Serving it over HTTP

Command	What it does	Reach for it when
ui	Serves the JSON API on a loopback socket for as long as you leave it running, printing the address and a token minted for that run	You are driving lemonfiber from a browser, a client or a script rather than a terminal. --assets <dir> serves a built web app beside it; --lan offers it to your network, once --set-password has set one

Words, and help

Command	What it does	Reach for it when
explain	Says what one of this product’s words means	A report used a word you do not have, and you want more than the sentence it gave you
help	Prints this message or the help of the given subcommand	You want the same text this site generates its reference from

Where to go next

The global flags apply to all of the above, and the terminal interface is what you get when you run none of them. If you are following what a command told you rather than choosing one, when something is wrong starts with the doctor. If you are writing a script against the output rather than reading it, the API and the SDKs describe the shape it arrives in.