Wormhole is a lightweight federated social media server which allows for efficient communication between ActivityPub servers.
- Fast -- Wormhole is written in modern C++ and utilizes efficient libraries such as RapidJSON for parsing.
- Lightweight -- Incredibly tiny resource usage, with the choice of SQLite or PostgreSQL for the backend.
- Portable -- Completely distributable, no need to compile from source to change a configuration option or run migrations. Wormhole is a self-contained powerful executable.
- Modular and Extensible -- Designed for easy development and drop-in implementations for new protocols, including run-time plugins and compile-time modules.
- Easy to setup -- Wormhole is very simple to setup; run the executable once to generate a config if not already done.
- Powerful when needed -- Nearly every component can be customized, from caching, federation thresholds, or even low-end database options.
- Compatible -- Bring your own Pleroma/mastodon database, switch between SQLite and Postgres, use your favorite client: Wormhole remains compatible in as many areas as possible
Of course, you are encouraged to build and try for yourself if you choose to disregard these claims! (see note above)
Wormhole provides thorough documentation regarding each component in
docs/ directory. Code is documented with Javadoc and can be
DoxyGen (as can the pages in the
to do so, run the following command:
Doxygen will generate HTML, Docbook, XML, and LaTeX files in
docs/doxygen directory. A HTML file that contains a redirect to
index.html file is simply placed for convience.
Wormhole uses CMake as the primary build system. Create a build directory, then run CMake to generate the build files, followed by your build mechanism (GNU Make).
$ mkdir build; cd build $ cmake -DCMAKE_BUILD_TYPE=Release .. $ make # use -j# to parallel compile quickly
Following the Installing steps afterwards.
When compiled with debug mode, debug logs will show up by default, extra asserts will be done, and the program can be debugged.
$ mkdir build; cd build $ cmake -DCMAKE_BUILD_TYPE=Debug .. $ make -j2
Assuming you've built wormhole in Release mode, you can now install (as root, of course)
# make install
Now setup your service or what-nots, and you're done!
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.