2.5 KiB
Sanctum
A private, self-hosted desktop client for mithraic.space
Built on Revolt — open source, no tracking, no telemetry, no nonsense.
Windows & Linux. Auto-updates from your own server.
What is this?
Sanctum is a custom fork of Stoat for Desktop, hardwired to connect exclusively to mithraic.space — a self-hosted Revolt instance. It replaces the default branding, icons, and update pipeline with a fully self-contained setup hosted on a private Forgejo instance.
No reliance on external services. Updates come from git.mithraic.cloud. Builds run on a self-hosted CI runner. Everything stays in-house.
Installing
Grab the latest build from the Releases page.
Linux
# extract to your local apps folder
mkdir -p ~/.local/share/sanctum
unzip Sanctum-linux-x64-*.zip -d ~/.local/share/sanctum/
# register it as a desktop app
cat > ~/.local/share/applications/sanctum.desktop << EOF
[Desktop Entry]
Name=Sanctum
Exec=$HOME/.local/share/sanctum/sanctum
Icon=$HOME/.local/share/sanctum/resources/assets/desktop/icon.png
Type=Application
Categories=Network;InstantMessaging;
StartupWMClass=sanctum
EOF
Then search for Sanctum in your app launcher and you're in.
Windows
Extract the zip, run sanctum.exe. That's it.
Auto-updates
Sanctum checks for new releases on every launch. When a newer version is available on git.mithraic.cloud, you'll get a desktop notification — click it to download. No background processes, no silent installs.
Building from source
You'll need Git, Node.js, and pnpm (corepack enable).
git clone https://git.mithraic.cloud/ad3laid3/sanctum
cd sanctum
pnpm i --frozen-lockfile
pnpm start
Releasing a new build
Push a version tag and CI does the rest — compiles Linux and Windows builds, creates a release, and uploads artifacts automatically.
git tag v1.x.x
git push origin v1.x.x
Building locally
# Linux (deb + zip)
PLATFORM=linux pnpm make
# Windows (zip, no Wine required)
pnpm make --platform win32 --arch x64
Output lands in out/make/.
Tech
- Electron + electron-forge
- Revolt open-source chat backend
- Forgejo for self-hosted git + CI
- Discord Rich Presence via discord-rpc