Skip to content

v0.9.0

Choose a tag to compare

@github-actions github-actions released this 27 Oct 10:20
· 30 commits to main since this release
Immutable release. Only release title and notes can be modified.
  • Hook commands: on_unready runs when a running server has not answered on its port or health path for unready_after (a minute unless set), and on_recover when a server that on_crash or on_unready reported is ready again, with PORTSIDE_RECOVERED_FROM and PORTSIDE_DOWNTIME. Like on_crash, both are set at the top level or per server, and one script can tell the events apart by PORTSIDE_EVENT.
  • Crash command: PORTSIDE_STREAK counts the crashes for good in a row without the server being ready in between, so a monitor that starts failed servers again can report each problem once, and PORTSIDE_TRIGGER says what began the run (start or restore). The streak and an open problem survive daemon restarts and upgrades.
  • umask (top level or per server) sets the mode mask for the files a server creates, such as "0007"; without it servers keep the daemon's, which launchd and systemd set to 0022, readable by other accounts.
  • login_env = false gives servers the daemon's own environment plus path and env instead of the login shell's, for servers whose environment the config alone should decide. portside doctor says which one servers get.
  • retry_after (top level or per server, for restart = "on-failure" or "always") starts a server again that long after its automatic restarts gave up or its start failed, with another 5 restarts, until it runs or you stop it; PORTSIDE_TRIGGER is then retry. The dashboard offers Stop while it waits, and the menu bar app still announces the crash.
  • Docs: the Linux server guide explains that systemctl --user restart portside stops every server, while portside daemon restart keeps them running.

Install

With Homebrew on macOS 26 or later (Apple Silicon), the app and the command:

brew install --cask padmk/tap/portside

On macOS or Linux (x86-64, arm64), the command and dashboard, built from source:

brew install --formula padmk/tap/portside

Portside-0.9.0.zip below is the same app, and the portside_*.tar.gz archives hold the command alone. See the README for details.