Skip to content

Releases

v1.3.0 — Crash restart, graceful stop, start at boot, alerts & --user

Choose a tag to compare

@luthfiyufajjiru luthfiyufajjiru released this 27 Oct 14:47
Immutable release. Only release title and notes can be modified.
3ccf037

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-failure restarts an app after a non-zero exit or a signal; --restart unless-stopped restarts it after any exit. Restarts back off at 1s, 2s, 4s, … (up to 1 min), give up after --max-restarts restarts in a row, and morrow stop cancels 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 detail shows 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 get MORROW_EVENT, MORROW_EXIT_CODE and related variables; webhooks get them as JSON. Hook targets are stored encrypted. Use hook list, hook test and hook remove to manage them.
  • Graceful stop. stop and restart send 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 startup starts, 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-failure and unless-stopped, with --max-restarts, backoff, and restarting status (#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 -e values (#20).
  • morrow hook add|list|test|remove: exec and webhook alerts on crash, exit and giveup (#20).
  • stop/restart --timeout for 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 all produced Windows x64 binaries for every target when make ran under sh. It now builds every platform correctly and checks each file's format (#17).

Upgrading

  • Replace the binary and run sudo morrow init once (Windows: as Administrator). Database migrations 000005–000008 run automatically.
  • Existing apps keep restart policy no. Apps running at upgrade time are marked as wanted, so sudo morrow startup brings 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 lifecycle and startup CI 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 .msi for your architecture, then from an Administrator terminal run morrow init and morrow 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

Choose a tag to compare

@luthfiyufajjiru luthfiyufajjiru released this 27 Oct 12:46
Immutable release. Only release title and notes can be modified.
60c82e7

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, then API_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. init requires sudo/Administrator, or set MORROW_HOME for 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. Running sudo morrow init once 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 --port are no longer mistaken for Morrow flags.
  • morrow uninstall with --dry-run, --purge (also deletes data, after typing purge) 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: 0600 on Linux/macOS; a protected ACL for SYSTEM + Administrators on Windows. Previously every Windows user could read it. Re-run morrow init as Administrator to fix existing installs.
  • Only morrow init creates the master key. A missing key no longer silently generates a new one that orphans existing secrets, and init refuses to replace a lost key while secured variables exist (--force to 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 stop never signals a reused PID.
  • start checks write access before launching, so a denied start leaves no untracked process; restart reports the real stop error.
  • logs no longer drops lines longer than 64 KB, and -f no 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/uninstall no 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 init needs sudo/Administrator; use MORROW_HOME for 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.
  • sudo no longer reveals secured values in detail; use sudo 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 -race on 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>, then sudo install -m 755 morrow-v1.2.0_linux-amd64 /usr/local/bin/morrow && sudo morrow init.
  • Windows: run the .msi for your architecture, then morrow init from an Administrator terminal.
  • Upgrading: replace the binary and run sudo morrow init once.

Pull requests: #13, #14, #15, #16 · Closes #8, #12

Full Changelog: v1.0.3...v1.2.0

ARMV7L Support

Choose a tag to compare

@luthfiyufajjiru luthfiyufajjiru released this 19 Apr 15:20
Immutable release. Only release title and notes can be modified.
c9880ac

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

Choose a tag to compare

@luthfiyufajjiru luthfiyufajjiru released this 19 Apr 14:51
Immutable release. Only release title and notes can be modified.
5231a0e

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

Choose a tag to compare

@luthfiyufajjiru luthfiyufajjiru released this 19 Apr 14:33
Immutable release. Only release title and notes can be modified.
949be64

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

Choose a tag to compare

@luthfiyufajjiru luthfiyufajjiru released this 19 Apr 10:50
f3965b2

What's Changed

New Contributors

Full Changelog: https://github.com/luthfiyufajjiru/morrow/commits/v1.0.0