Repository navigation
Releases
v1.3.0 — Crash restart, graceful stop, start at boot, alerts & --user
Morrow 1.3.0 makes it production-ready. Apps restart when they crash, stop gracefully, come back after a reboot, can run as their own unprivileged account, and can alert you when something goes wrong. Every feature is checked end to end on Linux and Windows in CI.
What's new
- Restart on crash.
--restart on-failurerestarts an app after a non-zero exit or a signal;--restart unless-stoppedrestarts it after any exit. Restarts back off at 1s, 2s, 4s, … (up to 1 min), give up after--max-restartsrestarts in a row, andmorrow stopcancels a pending restart. Each decision is written to the app's log. - Exact exit codes. Morrow now launches each app under its own supervisor, which sees the real exit code or the signal that killed it.
morrow detailshows it as Last Exit. - Crash alerts.
morrow hook add api --on crash,giveup --webhook https://…(or--exec "<command>") runs when an app exits unexpectedly. Commands getMORROW_EVENT,MORROW_EXIT_CODEand related variables; webhooks get them as JSON. Hook targets are stored encrypted. Usehook list,hook testandhook removeto manage them. - Graceful stop.
stopandrestartsend SIGTERM to the app and its child processes, wait up to--timeout(default 10s), then kill it, and return only once it is gone, so a restart never overlaps the old process. - Start at boot.
sudo morrow startupstarts, at every boot, the apps you started and did not stop. On Linux it is a systemd unit, which also stops apps gracefully at shutdown. On Windows it is a scheduled task running as SYSTEM, so those apps keep running when users log off. - Run apps as a dedicated account.
morrow create --user svc-api …runs the app as that account instead of root/Administrator, so a compromised app can't read the master key or other apps' data. On Windows, pass the account's password with--password-env VAR; it is stored encrypted.
Changelog
Features
- Restart policies
no(default),on-failureandunless-stopped, with--max-restarts, backoff, andrestartingstatus (#18, #20). - Supervisor-as-parent: real exit codes and signals, recorded in Last Exit. Restarts re-read the app's variables, so rotated secrets apply, and keep
start -evalues (#20). morrow hook add|list|test|remove: exec and webhook alerts oncrash,exitandgiveup(#20).stop/restart --timeoutfor graceful shutdown of the whole process group (#18).morrow startup [--status] [--remove]: per-app desired state, systemd unit or Windows scheduled task, graceful stop at shutdown (#19).create/update --user <account> [--password-env VAR]to run an app as another account (#21).
Fixes
- A stale supervisor can no longer mark a newer instance of the same app as stopped.
- On Windows, hook commands containing quotes now work, and one exit's hooks run in order.
make allproduced Windows x64 binaries for every target whenmakeran undersh. It now builds every platform correctly and checks each file's format (#17).
Upgrading
- Replace the binary and run
sudo morrow initonce (Windows: as Administrator). Database migrations 000005–000008 run automatically. - Existing apps keep restart policy
no. Apps running at upgrade time are marked as wanted, sosudo morrow startupbrings them back after a reboot. - Apps started by v1.2.0 keep their old supervisor until restarted. Run
sudo morrow restart <app>to get exit codes, policies and hooks for them.
Tests and CI
- New
lifecycleandstartupCI jobs on Linux and Windows test real processes: graceful stop, timeouts, crash loops, hooks, a simulated reboot with systemd and with the Windows scheduled task, and run-as checks in the permission matrix. CI now runs 14 jobs on every PR.
Install
- Linux:
sudo install -m 755 morrow-v1.3.0_linux-amd64 /usr/local/bin/morrow && sudo morrow init && sudo morrow startup - Windows: run the
.msifor your architecture, then from an Administrator terminal runmorrow initandmorrow startup. - Guide: tutorial and FAQ
Pull requests: #17, #18, #19, #20, #21, #22 · Closes #9
Full Changelog: v1.2.0...v1.3.0
v1.2.0 — Write-only secrets, safer permissions, uninstall & completion
Morrow 1.2.0 is a security and operations release. Secrets stay secret: detail never prints them, only root/Administrators can read them, and CI/CD pipelines can set them without being able to read them back. Data now lives in standard system folders, and Morrow gains working directories, uninstall, and shell completion. Every change is checked on Linux and Windows by a new end-to-end permission test in CI.
What's new
- Write-only secrets for pipelines. A non-admin account (e.g. CI) can set the variables an admin granted it, and can never read any secret, including its own submissions.
sudo morrow init --enable-inbox,sudo morrow grant ci --app api --vars API_TOKEN, thenAPI_TOKEN="$CI_TOKEN" morrow submit-env api API_TOKEN --restart. Values are sealed with a public key, checked against the grant, a denylist (PATH,LD_*,NODE_OPTIONS, …) and a value format, and applied automatically by a systemd unit or scheduled task. - Clear sudo / non-sudo model. On a system install, regular users can read (
list,status,detail,list-env, secrets masked) but not change anything.initrequires sudo/Administrator, or setMORROW_HOMEfor a per-user install that needs none. - Data out of the binary's folder.
/etc/morrow(key),/var/lib/morrow(database),/var/log/morrow(logs); Windows:%ProgramData%\Morrow. Runningsudo morrow initonce migrates older installs. - Working directory per app:
morrow create -w /srv/api api ./venv/bin/python main.py --port 8080(issue #12). App arguments such as--portare no longer mistaken for Morrow flags. morrow uninstallwith--dry-run,--purge(also deletes data, after typingpurge) and--backup-key. By default it keeps your data, so reinstalling resumes where you left off.- Shell completion for bash, zsh, fish and PowerShell:
morrow completion <shell>. Tab completes app and variable names. - Docs: a full tutorial and FAQ (also in the wiki), and README demo GIFs recorded from real runs.
Changelog
Security
detail(table,--json, Full Command) no longer prints decrypted secrets.- Access to secured values follows the master key's file permissions, not "is root". Windows was previously always treated as root.
- Master key locked down:
0600on Linux/macOS; a protected ACL for SYSTEM + Administrators on Windows. Previously every Windows user could read it. Re-runmorrow initas Administrator to fix existing installs. - Only
morrow initcreates the master key. A missing key no longer silently generates a new one that orphans existing secrets, andinitrefuses to replace a lost key while secured variables exist (--forceto accept losing them). - Logs are root/Administrator-only, because apps may print secrets.
Fixes
- A dead process ID is treated as stopped: no more "already running" after a crash or reboot, and
stopnever signals a reused PID. startchecks write access before launching, so a denied start leaves no untracked process;restartreports the real stop error.logsno longer drops lines longer than 64 KB, and-fno longer misses lines.- Database migrations run automatically on every command, so upgrading no longer breaks older databases.
- SQLite busy timeout: a log relay and
stop/restart/uninstallno longer fail with "database is locked" when they write at the same time. - Permission errors say to use sudo / an Administrator terminal instead of "readonly database".
Breaking or behavior changes
- System-install
initneeds sudo/Administrator; useMORROW_HOMEfor per-user installs. - Morrow flags go before the app name:
morrow create -w DIR app exe args…. Everything after the executable goes to the app. sudono longer reveals secured values indetail; usesudo morrow get-env.- Data moves to system folders after
sudo morrow init(the old location keeps working until then).
Under the hood
- Go 1.27.3; unit tests for every package; GitHub Actions for gofmt, vet, tests (with
-raceon Linux), all six build targets, and an end-to-end permission matrix on Linux and Windows.
Install
- Linux: download
morrow-v1.2.0_linux-<arch>, thensudo install -m 755 morrow-v1.2.0_linux-amd64 /usr/local/bin/morrow && sudo morrow init. - Windows: run the
.msifor your architecture, thenmorrow initfrom an Administrator terminal. - Upgrading: replace the binary and run
sudo morrow initonce.
Pull requests: #13, #14, #15, #16 · Closes #8, #12
Full Changelog: v1.0.3...v1.2.0
ARMV7L Support
What's Changed
- feat: bump version to 1.0.3 and add support for Linux ARM32 build target by @luthfiyufajjiru in #10
Full Changelog: v1.0.2.1...v1.0.3
Fix Log Following Mode
What's Changed
- feat: implement CLI application management commands and bump version … by @luthfiyufajjiru in #6
Full Changelog: v1.0.1...v1.0.2.1
Logs feature and Background Issue
What's Changed
- feat: implement sidecar log relay, detached processes, and logs command by @luthfiyufajjiru in #5
Full Changelog: v1.0.0...v1.0.1
Version 1.0.0
What's Changed
- feat: initial features implementation by @luthfiyufajjiru in #1
New Contributors
- @luthfiyufajjiru made their first contribution in #1
Full Changelog: https://github.com/luthfiyufajjiru/morrow/commits/v1.0.0