Repository files navigation

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

You can test Zusam right now onhttps://demo.zusam.org
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 usesSymfony andSqlite,the frontend is made withPreact andParcelJS.

Requirements:

• PHP 8.1+ (with iconv, mbstring, curl, xml, sqlite3 and imagick extensions)
• Ffmpeg 3+

Installation guides:

• Debian buster with nginx
• Debian buster with apache
• Docker

The project has the goal of being really stable for the backend once1.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 significantevolutions with upcoming updates and doesn't guarantee backwards compatibility.
I try my best to make updates as easy as possible.

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 licensedunderAGPLv3.
You can open issues for bugs you've found or features you think are missing, or submit pull requests to this repository. SeeCONTRIBUTING.md for more information.

Zusam is being translated usingWeblate: