A lightweight, federated and powerful microblogging server written in Nim. Pothole allows you to control your digital life!
Note: Pothole is a work-in-progress. Lots of implementation details are being figured out just now and are thus likely to change over time. In other words, this is pre-alpha or even research stage.
Note: This is the main branch which contains a bleeding-edge codebase, which isn't stable at all for production environments, consider downloading the stable branch instead which is more stable. (Although, there is no stable branch as of yet since nothing works yet) So pick your poison! stability or bleeding-edge (or pick a specific feature branch to test out a feature if you are a developer.)
Pothole is a microblogging server written in Nim, it's designed to be simple & fast. It has unique features such as allowing user-profiles to be customized. Pothole is far more reminiscent of Tumblr in this sense since it allows you to customize your profile and unleash your creativity in ways that other microblogging services simply cannot do.
Pothole federates to other servers using the ActivityPub protocol which means you can communicate to users on Mastodon, Akkoma, Misskey or whatever website that implements ActivityPub. Pothole is also compatible with Mastodon's API interface, so your clients, frontends and bots should work with little to no changes.
No. You are better off using Pleroma for a stable backend or GoToSocial for a light-as-air backend.
Development is slow because creating anything remotely like this is incredibly difficult, I am trying to emphasize speed & safety over shiny features, and that means I keep planning ahead for new things and that's why this is taking so long. Pothole is still in a sort-of research state, I believe it will stabilize over the coming months but I can't guarantee anything.
Install nim, your favorite C compiler (we recommend gcc) and nimble. Run nimble -d:release build and it will build with release settings. (You might need to install postgres as a development library)
Pothole's main database is postgres, and so it expects an actively-running postgres server process in the background to work. You can change the database connection settings by editting the pothole.conf configuration file. If you don't want to (or can't) install postgres but you have access to docker, then you can run the potholectl db docker command to generate a postgres database docker container configured for pothole. potholectl can be found in the build/ folder when you finish building pothole.
Assuming you did not change the port that pothole uses in the configuration file, head over to 127.0.0.1:3500 and experience its glory!
Copyright © penguintie penguinite@tuta.io 2024 Copyright © Leo Gavilieau xmoo@privacyrequired.com 2022-2023
In January 2024, I was asked to maintain this project by Leo Gavilieau, it seems as if they no longer wanted it. So I am the new project leader!
Licensed under GNU Affero General Public License version 3 or later. A copy is is available as the LICENSE file.