What is ferdium-server?

Ferdium-server is the backend component for Ferdium, a community-driven messaging aggregator that combines multiple web services into one application. The server handles user registration and authentication, workspace management, service/recipe storage, and data import/export. It can run with a built-in SQLite database or connect to external MySQL, MariaDB, or PostgreSQL databases. The server is deployed via Docker (image: ferdium/ferdium-server) or manually with Node.js. It exposes a REST API on port 3333 that the Ferdium desktop/mobile clients connect to. Key features include user dashboards, custom recipe creation, Franz/Ferdi account import, and workspace support. The project is licensed under MIT and actively maintained by the Ferdium organization.

Should you self-host ferdium-server?

ferdium-server scores 49/100 on selfhost.directory (how scoring works) and ranks #29 of 33 in Communication. It has 302 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Jitsi Meet (79/100, 30 159 stars). It scores higher overall, so compare the two before you pick. See ferdium-server vs Jitsi Meet side by side.

Features

Custom recipe creation
Data Export/Import
Franz/Ferdi account import
Multiple database support
Password Recovery
Recipe updates
Service/recipe management
Service store
SMTP email notifications
User dashboard
User registration and login
Workspace support

FAQ

How do I create custom recipes?

Visit http://[YOUR FERDIUM-SERVER]/new in your browser to define the recipe author, name, service ID, logo image URL, and upload recipe files. The server packages and stores them automatically.

How do I import my Franz/Ferdi account?

Open http://[YOUR FERDIUM-SERVER]/import in your browser and log in with your Franz/Ferdi credentials. The server will create a new user and copy your settings, services, and workspaces.

Why use a custom Ferdium server?

A custom server lets you manage all user data yourself and add your own recipes to the repository, instead of relying on the official instance at api.ferdium.org.