keeping solstone up to date
running the current version fixes a surprising number of issues, and it's the first thing worth ruling out.
check your version
open about in your journal's settings (or run solstone journal about in a terminal, which on a mac means open admin terminal in the journal app's journal menu; on a journal older than 2.0.30, run journal --version) to see your version, then compare it against the latest release. finding your version shows where about is on each app. if you're a version or two behind, the update may already contain your fix.
one number, everywhere: since 1.0.12 the journal reports the same version whether you installed it yourself or run the journal on your mac. the two used to count releases separately, which is why the number jumped from 0.9.x to 1.0.x. nothing was skipped. the solstone app on your mac still keeps its own version number.
update the journal
if you installed the journal using the install command from the install page (on linux), one command updates it in place:
curl -fsSL https://solstone.app/install.sh | sh -s -- --upgrade
this keeps the release lane you're already on and checks the signed release before installing it. with journal 2.0.82 or later, a journal installed this way, not as a package, also updates itself in the background, and the new version starts the next time your journal does. a new install turns this on and says so, and one you already have asks you once in your journal's status pane. if solstone for tmux was installed the same way, the command asks before moving it into the solstone app. the install page says more.
if you added the solstone package repository, your system's updater keeps your journal up to date, and the install guide says what to run after. if you installed the linux .deb or .rpm package yourself, without that repository, run the same command once. it takes the package over, replacing an older one with the current signed release. it needs sudo for the package, so run sudo -v first. after that, the same command or solstone update keeps it up to date. the install guide has the details.
only using solstone on linux to talk to a journal on another machine, with no journal on the computer you run it on? the same install covers that too, so the command above is still the one to run: there's no separate download for it anymore.
on mac, each app handles its own updates: see "the two mac apps update on their own clocks" below.
on windows, with journal 2.0.75 or later, the journal app updates your journal on its own: it downloads an update in the background and installs it the next time the app starts. its updates page, in the journal app from the start menu, still lets you check and install right away (journal 2.0.33 or later). or download the newer installer for your pc from the journal download page and run it again. if an older install put your journal inside the program folder (normally %LOCALAPPDATA%\SolstoneJournal), running the installer again or uninstalling can delete it, so move it out first. the steps for moving it are under "uninstall on windows" in the install guide. a journal anywhere else is kept.
the two mac apps update on their own clocks
the solstone app (the menu-bar app) and the journal app (the dock app) are separate apps with separate updaters. each downloads its own updates and installs them when you quit and reopen it, and asks you to restart if you leave it open. see the two mac apps if you're not sure which is which or why there are two.
windows update channels
how the solstone app updates depends on how you installed it:
- direct install (the signed installer from solstone.app/download/windows) and winget (
winget install solstone, which installs that same signed installer): update the solstone app from inside the app. it checks for updates on its own, and from version 2.0.47 of the solstone app it also downloads them and installs one the next time it starts. in the solstone app's settings, under updates, you can check now and change how it updates. - Scoop:
scoop update solstone
the journal on windows is separate from the solstone app above, and it updates from its own app or its own installer. see "update the journal" for how.
after updating
open a terminal on the computer that runs your journal. on a mac, choose open admin terminal from the journal app's journal menu; the install guide says more. then run:
solstone journal doctor
confirms everything came back up cleanly. if something's still off, see when a lot seems broken at once: check your journal's health first, or file a request from the form at https://support.solstone.app/.