r/SelfHosting • u/valepiskiii • 6m ago
OpenSync - self hostable steam and steam cloud alternative
Good evening everyone, for disclosure this post is written entirely by hand
i wanted to share a project on which i've been working on since August with a couple of friends. it's a self-hosted game library and differential save-sync server and it comes with its linux, windows and macos native desktop launcher.
[WEBSITE: https://opensync.pskv.cc ]
[REPO: https://github.com/piskevalee-cpu/OpenSync ]
[LAUNCHER REPO: https://github.com/piskevalee-cpu/OpenSync-Launcher ]
The problem it solves
I keep offline and DRM-free PC game builds on my home server so multiple machines (my main desktop, a Linux couch PC, and family laptops) can pull them down without re-downloading over the internet or plugging in external drives. The annoying part has always been keeping saves and game installs separate across machines and users.
OpenSync stores every game on the server as a normal live folder paired with a SHA-256 JSON manifest. When a player downloads a game, the server streams a ZIP on the fly in uncompressed STORE mode (so a local gigabit or 2.5G link is not bottlenecked by CPU compression) while merging:
clean baseline + user overlay - user deletions
Every user gets their own save overlay computed by diffing against the shared clean manifest, never chained across overlays, with a safety guard that blocks accidental mass deletions (>50% of the manifest) unless explicitly forced
Before writing this, I looked at combining existing tools:
- Samba / Nextcloud / HTTP file shares: Great for storing files, but every client downloads raw folders manually, and there is no clean per-user save isolation on top of one shared read-only game build.
- Syncthing: Works well for syncing one known save directory, but bidirectional folder sync gets risky if you accidentally wipe files, does not understand a shared baseline vs. per-user save overlays, and still leaves you configuring paths machine by machine.
- Ludusavi: Awesome for backing up saves when you already know where every game writes, but it is a backup utility rather than a central LAN distribution server that streams the game itself and merges your saves into the download automatically.
- RomM / emulator frontends: Focused on ROMs and console emulators rather than arbitrary uncompressed Windows/Linux/macOS PC game directories.
Why this project is relecant to this sub:
- Simple to host: Runs as a single Docker container (
ghcr.io/piskevalee-cpu/opensync,linux/amd64) or directly on Node.js 22.13+ using built-innode:sqlite. Everything persistent (SQLite metadata, game directories, user overlays, and signing secret) lives under one/datavolume, so backing up or migrating the server is trivial. - Optimized Rust streaming: Zero temporary zip files on disk on either the server or the desktop launcher. Downloads extract straight from the HTTP stream while verifying SHA-256 hashes inline.
- Cross-platform desktop client: Written in Rust and Tauri v2, supporting Linux (AppImage and Flatpak), Windows (
.exe), and macOS (Apple Silicon and Intel.dmg/.app), with automatic ELF/PE/Mach-O executable detection, Proton/Wine support, gamepad navigation, and automatic save sync as soon as a game closes (plus offline queueing if you play away from home). - Multi-user: Account registration, per-user profile pictures, role-based admin panel, and isolated save overlays so different people in a house can play the same game archive without touching each other's progress.
After writing by hand the first sketch of the sync saving mechanism, I do admit to using an AI coding assistant during development, mainly for accelerating boilerplate, CSS styling and responsive layout tweaks, writing unit and integration tests, refactoring Rust async command boundaries, and setting up cross-platform CI packaging workflows (Linux, Windows, and macOS builds). I directed the overall architecture, manifest and overlay sync model, feature set, and manual testing across my own machines, and reviewed and verified all changes against the test suites before releasing. However, art is human made!
NOTE: This project is still in rather early developement, especially the desktop client. i do not have a windows machine so i could not test the windows client. We are seeking contributors to help out with this project that, although new and niche, really did come a long way.
thanks to everyone who's going to check this out