Skip to content

Run your own servers

The server source code is public on GitHub.

gim-hub is written in Rust: the client API (REST and WebSocket), federation between hubs and multi-homing. It keeps its data in SQLite under a data directory. With Docker:

Terminal window
git clone https://github.com/gimhq/gim-hub.git
cd gim-hub
docker build -t gim-hub .
docker run -d --name gim-hub -p 8080:8080 -v gim-hub-data:/data gim-hub
curl http://127.0.0.1:8080/healthz

Linux builds for x86_64 and aarch64 are on the releases page. Configuration, the data directory, backups and federation are in operating a hub; the admin API and UI in admin API; waking phones in push gateway.

gim-keep runs on Bun, or on Cloudflare Workers. It stores the sealed settings slots and gives moderators an inbox for reports. Its README covers running it, and docs/modules/gim.md the gim part.

Then point the apps at your servers (hubs and the keep server).