Run it locally

Everything runs through rer from the Locket folder.

Start and stop

rer dev
rer dev --stop

rer dev installs what is missing, sets up the owner the first time, starts Locket and prints a link that opens it signed in. Running it again while it is up reuses the running app. It keeps the port it chose the first time, from 8787 up, and listens only on this computer.

Check and inspect

rer verify
rer describe
rer doctor

rer verify builds Locket and runs its checks. rer describe lists the commands and flags this checkout supports.

Where your data lives

Your agreements and files live in .wrangler/state inside the Locket folder. Private settings live in .dev.vars, readable only by you. Keep both out of anything you share. To copy or move an installation, see Back up and restore.

On your own computer, sign-in emails go to a local outbox instead of the internet: the sign-in page links to it.

Your own server

rer deploy puts Locket on your own Cloudflare account. It needs that account's credentials and a real email provider for sign-in links; rer deploy --dry-run builds and checks everything without contacting Cloudflare. The details are in RUN-LOCALLY.md.