Repository navigation
v0.9.0
·
30 commits
to main
since this release
Immutable
release. Only release title and notes can be modified.
- Hook commands:
on_unreadyruns when a running server has not answered on its port orhealthpath forunready_after(a minute unless set), andon_recoverwhen a server thaton_crashoron_unreadyreported is ready again, withPORTSIDE_RECOVERED_FROMandPORTSIDE_DOWNTIME. Likeon_crash, both are set at the top level or per server, and one script can tell the events apart byPORTSIDE_EVENT. - Crash command:
PORTSIDE_STREAKcounts 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, andPORTSIDE_TRIGGERsays what began the run (startorrestore). 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 to0022, readable by other accounts.login_env = falsegives servers the daemon's own environment pluspathandenvinstead of the login shell's, for servers whose environment the config alone should decide.portside doctorsays which one servers get.retry_after(top level or per server, forrestart = "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_TRIGGERis thenretry. 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 portsidestops every server, whileportside daemon restartkeeps them running.
Install
With Homebrew on macOS 26 or later (Apple Silicon), the app and the command:
brew install --cask padmk/tap/portsideOn macOS or Linux (x86-64, arm64), the command and dashboard, built from source:
brew install --formula padmk/tap/portsidePortside-0.9.0.zip below is the same app, and the portside_*.tar.gz archives hold the command alone. See the README for details.