Skip to content
Private groups made easy.
JavaScript PHP CSS HTML Other
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
api Remove lock test on image processing Aug 22, 2019
app Update changelog and compile webapp Aug 23, 2019
bin Fix container script in case of git worktree Aug 22, 2019
data Add data/cache & data/files directories Aug 22, 2019
docker Update dockerfiles packages Aug 1, 2019
public Add public/files symlink Oct 18, 2018
readme Fix ACLs Mar 16, 2019
.dockerignore Small adjustements to the container Mar 7, 2019
.gitignore Fixes Apr 10, 2019 Update changelog and compile webapp Aug 23, 2019
Dockerfile Update dockerfiles packages Aug 1, 2019
LICENSE Fix ACLs Mar 16, 2019 Add data/cache & data/files directories Aug 22, 2019

A truly private space for you and your friends

What is Zusam ?

Zusam (/tsuˈzam/) is a free and open-source way to self-host private forums for groups of friends. Composed of a server written in PHP exposing a REST API and a lightweight webapp, Zusam is extensible and easy to install.
The goal is to make a stable, extensible, lightweight and user-friendly way to self-host private social groups.

More screenshots here


You can test Zusam right now on
The login is "zusam" and the password is "zusam". The instance is reset every hour.


  • Links preview and embedded youtube, vimeo, imgur, soundcloud, twitch, bandcamp...
  • Video and image upload
  • Photo albums
  • Public link generation for messages
  • Completely responsive and mobile friendly
  • Low server footprint


Zusam is composed of a PHP server and a single-page-application. The backend uses Symfony and Sqlite, the frontend is made with Preact and ParcelJS.


  • PHP 7.2+ (with mbstring, curl, xml, sqlite3, imagick and intl extensions)
  • Ffmpeg 3+
  • Yarn or NPM (only to compile the webapp)

Installation guides:


The project has the goal of being really stable for the backend once 1.0 is hit. That means no database structure changes, an update system and a stable API.
The webapp can still change a lot after that point.
For now, Zusam is completely usable in a day-to-day basis but is subject to significative evolutions with upcoming updates and doesn't garantee backwards compatibility.
I try my best to make updates as easy as possible.

Webapp compatibility

The webapp targets Firefox ESR and at most one-year old Chrome.
It should work on the latest versions of Edge and Safari but is not tested on them.


Zusam is free and open-source software licensed under AGPLv3.
You can open issues for bugs you've found or features you think are missing. You can also submit pull requests to this repository.

You can’t perform that action at this time.