Repository navigation
v0.10.0
·
27 commits
to main
since this release
Immutable
release. Only release title and notes can be modified.
- Tasks:
oneshot = truemakes an entry a task that runs to completion, such as a migration. Servers thatdepends_onit start once it exits with code 0, and arecrashedwith a note such asdependency migrate failed: exited with code 1when it fails.ensure,up --waitandensure_serverrun the task again and wait for its end; servers started together share one run. A task has no port, shows as done after a successful run, and counts forportside checkonly while it runs, when it failed, or when you name it (Tasks). - Schedules:
schedule = "30 2 * * *"starts a task or server at the times a crontab expression matches, in local time (five fields, names, ranges, lists, steps and@dailystyle macros). A run missed during sleep or while the daemon was down happens once afterwards, a server still running skips the run,PORTSIDE_TRIGGERisschedule, andenabled = falsepauses it.portside status, the dashboard andlist_serversshow the next run (Schedules). memory_limit(top level or per server, such as"2GB";"0"turns an inherited one off) stops a server whose processes use more memory, checked with each usage sample (every 30 seconds, every 2 seconds while the dashboard shows usage). It counts as a crash with a note such asused 2.3 GB, over memory_limit 2 GB: the restart policy applies andon_crashgets the note. Worktree copies have their server's limit; containers are not covered (Memory limit).watch = ["src/**/*.py", "pyproject.toml"]restarts a server once changes to the files it matches, relative to itsdir, have stopped for about a second, and starts a crashed one again after a change, so fixing the error brings it back. The log names the change (restarting: changed src/app.py (+3 more)) andPORTSIDE_TRIGGERiswatch. A server you stopped ignores changes, and a task restarts only while it runs. Files are polled every second, only in directories a pattern can match, skipping.git,node_modulesand similar folders unless a pattern names them. The dashboard marks such a server watching (Restart on file changes).- Hook commands:
PORTSIDE_TIMEgives when the event happened (RFC 3339), so a monitor can order reports whose commands finished out of order. - Fixed: an automatic restart still waiting for its backoff when the daemon upgraded in place was lost with
restore = false, or happened at once with a fresh count of restarts; it now happens at its time in the new daemon and continues the count, unless the config the new daemon loads setsrestart = "no". - Fixed: a server that was still starting when the daemon upgraded in place no longer stays down with
restore = false, nor when the upgrade fails: the start goes on.
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.10.0.zip below is the same app, and the portside_*.tar.gz archives hold the command alone. See the README for details.