Repository navigation
FAQ
Is Morrow like PM2? It has PM2-style commands but no resident daemon and no Node.js. It is a single Go binary; each command runs and exits, and only a small log relay per app keeps running. With --restart unless-stopped its log relay restarts crashed apps with backoff. morrow startup starts apps at boot. It does not run apps in cluster mode.
Do I need sudo for everything? On a system install, for anything that changes state or reveals a secret. Reading status does not need it. In per-user mode you never need it.
Can a regular user see my secrets? No. They see ****. The key is readable only by root/Administrators, and the CI permission tests try to read it, copy the database, plant files and use their own key; all of that fails.
Can Morrow tell me when an app crashes? Yes: morrow hook add runs a command or calls a webhook (Slack, PagerDuty, your own endpoint) on crash, exit or giveup. See Run your first app.
Can my CI/CD pipeline set secrets without being admin? Yes, with the inbox (see Let a pipeline set secrets it cannot read). It can only set the variables you granted, in the format you chose, and cannot read any secret, including the ones it submitted.
Why can't I just give the pipeline sudo morrow set-env? set-env takes several KEY=VALUE pairs, so a sudo rule with a wildcard lets it set LD_PRELOAD or NODE_OPTIONS and run code as root. The inbox only accepts the granted names and formats.
Why can't the pipeline use its own per-user install? It can, if its apps should run as the pipeline user. But then the pipeline owns that install's key and can read every secret in it.
Does detail ever show secrets? No. It always masks secured values, including in --json and "Full Command". Use sudo morrow get-env to see one value.
Where do my app's logs go and who can read them? <logs>/<app>.log (/var/log/morrow or %ProgramData%\Morrow\logs). Only root/Administrators, because apps sometimes print secrets.
What happens after a reboot? With sudo morrow startup installed, the apps you had started (and not stopped) start again automatically. Without it, morrow list shows them as stopped until you start them.
Does the inbox work in per-user mode? No, there is no one to protect secrets from there. Use set-env.
On Windows, who runs apps that morrow apply --restart restarts? The scheduled task runs as SYSTEM, so apps it restarts run as SYSTEM. Apps you restart from an Administrator terminal run as you.
How do I remove the inbox, or Morrow entirely? sudo morrow uninstall stops the apps and removes the inbox (hook, folder, keys, group) but keeps your data; add --purge to delete the data too (see Uninstalling). Grants stay in the database, so sudo morrow init --enable-inbox brings the inbox back as it was.
How do I move Morrow to another server? Copy the database and the master key (keep the key private), install the binary, then run sudo morrow init on the new server: it keeps an existing key and re-applies its permissions.
Generated from doc/tutorial.md. Edit it there; wiki edits are overwritten on the next sync.