Keeps Basalt Server and Proxy up to date automatically.
Hoist is a launcher for Basalt Server and
Basalt Proxy. It runs the product as a child process, watches GitHub for a
new release or nightly, and applies it the way you configured: at a daily restart, when a condition you wrote is
true, on demand, or straight away.
Updates are safe: a download is checked against SHA256SUMS, the product is stopped cleanly, the previous version is
kept, and a version that fails to start is rolled back by itself. Hoist also takes scheduled and pre-update backups.
One folder holds one product and one Hoist.
mkdir my-server && cd my-server
hoist init --target server # or --target proxy
hoist run # installs the latest release, starts it, keeps it up to dateHoist only announces a new version until you enable a way to apply it in config/hoist/schedule.toml.
| Command | What it does |
|---|---|
hoist run |
Start the product and keep it running |
hoist check |
Look for a new version now |
hoist status |
Show what is installed |
hoist update |
Apply the pending update now |
hoist rollback |
Go back to the previous version |
hoist backup |
Create, list, restore and delete backups |
git clone https://github.com/BasaltProject/Hoist.git
cd Hoist
cmake --preset release
cmake --build build/releaseNeeds CMake 3.28+, Ninja, Clang and vcpkg. Examples for systemd and Docker are
in docs/examples.