Self-host flohmarkt
0.6.1Federated fediverse platform for local classified ads
- Port
- 8000 (Web application (uvicorn) HTTP port)
- Requires
- CouchDB
codeberg.org/flohmarkt/flohmarktWhat is flohmarkt?
flohmarkt is a decentral, federated platform for small advertisements (classified ads) built on ActivityPub. Registered users publish ads through a simple form; visitors who are not logged in can browse them, and replies work via fediverse accounts: an ad shows up as a note that can be boosted, followed or answered with a direct message from any compatible server such as Mastodon. Servers pick a community center point and radius at setup and can manually federate with nearby flohmarkts, aggregating their listings to keep trades local. Registration happens on the instance itself with email confirmation and can be switched off for single-person servers. Operators run it with Docker Compose using a prebuilt image plus a CouchDB service, follow a manual Debian install (Python 3.12, uvicorn behind a reverse proxy), or use NixOS or the Yunohost app catalog; the app listens on port 8000. It is AGPL-3.0 licensed, funded by NLnet and Prototypefund, and only numbered releases (never master) should be installed in production.
flohmarkt alternatives
- PieFedPieFed is an open-source, self-hosted fediverse forum and link aggregator in Python/Flask with topics, polls, community wikis and first-rate moderation tools.ComparePieFed with flohmarkt
FlusFlus is a self-hosted, open-source feed aggregator and social bookmarking tool combining RSS/Atom/JSON feeds, read-later lists, and link sharing with collections.CompareFlus with flohmarkt
MastodonOpen-source self-hosted microblogging server that federates over ActivityPub, with chronological timelines, media posts, moderation tools and an OAuth2 REST API.CompareMastodon with flohmarkt
PixelFedA self-hosted, open-source photo and video social network that federates over ActivityPub with albums, stories, direct messages and chronological feeds.ComparePixelFed with flohmarkt
PostmarksPostmarks is a self-hosted, open-source bookmarking site connecting to the Fediverse via ActivityPub to interact with Mastodon and other platforms.ComparePostmarks with flohmarkt
LemmySelf-hosted, open-source fediverse link aggregator and forum: federated communities, upvotes, threaded comments, mod logs. Built in Rust, deployed via Docker or Ansible.CompareLemmy with flohmarkt
mbinSelf-hosted fediverse platform for content aggregation, voting, discussions and microblogging. Replaces Reddit with ActivityPub federation to Mastodon, Lemmy, PeerTube.Comparembin with flohmarkt
bonfire-appBonfire is a self-hosted framework for creating federated community spaces with modular extensions and granular privacy controls.Comparebonfire-app with flohmarkt
Should you self-host flohmarkt?
flohmarkt scores 56/100 on selfhost.directory (how scoring works) and ranks #1 of 3 in Marketplace.
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 AGPL-3.0-licensed.
Its closest alternative on selfhost.directory is ShopClass (51/100, 114 stars). flohmarkt scores higher overall. See flohmarkt vs ShopClass side by side.
Features
- ActivityPub Federation
- Admin web interface
- Boosting of ads from fediverse clients
- Classified ad listings
- Content moderation
- Email-confirmed registration
- Fediverse direct-message replies
- Followable fediverse accounts
- Geo-scoped federation between instances
- Internationalization
- Markdown Rendering
- Notification system
- OAuth2 / Fediauth login
- Public browsing without login
- Registration can be disabled
How to install flohmarkt
Install flohmarkt with Docker Compose
FLOHMARKT_VERSION, LANG- Get the docker files
wget -O docker-compose.yaml https://codeberg.org/flohmarkt/flohmarkt/raw/branch/master/docker-compose_prod_prebuilt.yaml wget -O .env https://codeberg.org/flohmarkt/flohmarkt/raw/branch/master/example.env
Prebuilt image; after editing .env, run `docker-compose up`, complete the web setup page, then `docker-compose up -d`.
FAQ
Why does setup return 422 Unprocessable Entity?
The setup data was probably rejected because you forgot to click the centre point of your perimeter on the map.
Why is the admin account not accessible?
The initial setup process may have failed (for example not clicking a point on the map); you can restart the instance and click the setup link again.
Who follows whom?
Articles of instances you follow are shown locally, while your local articles are shown to your followers.
Why are no articles from federated sites shown?
After the remote instance accepts your follow (the button changes from Withdraw to Unfollow), its new ads appear in your catalogue; ads posted before you followed are not shown.
Why do I get 400 Bad Request when trying to federate?
When adding an instance in the admin federation tab, the URL must not have a trailing slash.
Why do I get no registration email?
Most likely the mail server settings are not correct.
What is a 4xx error message?
The HTTP result codes and error messages flohmarkt prints to stdout when serving requests, visible when running uvicorn from the command line.
What is flohmarkt?
A Chaos Camp 2023 presentation video and an article describe the project; you can also test interacting with an existing instance using your fediverse account.
More in Marketplace
GumroadGumroad's open-source (MIT) e-commerce code for creators selling digital products and subscriptions — self-hosted from source as a Rails app with MySQL and Redis.
MobazhaSelf-hosted open-source P2P commerce platform where sellers own their storefront and data, connecting to shared marketplaces with multi-chain crypto payments.
Mobazha UnifiedSelf-hosted, open-source commerce frontend for storefronts, marketplace discovery, checkout, and seller management, connecting to a self-hosted Node for crypto payments.
SharetribeSharetribe Go is Sharetribe's old source-available marketplace software, which was also available as a hosted SaaS product. Sharetribe Go is no longer actively maintained.
ShopClassShopClass is a self-hosted, open-source classifieds platform in PHP for marketplaces, job boards, and property sites with custom fields and paid listings.
ShopstrShopstr is a self-hosted, open-source Nostr marketplace enabling censorship-resistant Bitcoin commerce via Lightning and Cashu with no KYC or platform fees.
Spree CommerceSelf-hosted, open-source headless commerce platform with Store, Admin and Seller REST APIs, typed SDKs, a React admin and a Next.js storefront.
AimeosLaravel shop distribution for online stores, multi-vendor marketplaces and B2B sites; self-hosted and open-source, with JSON REST, GraphQL and MCP APIs.
BagistoOpen-source Laravel eCommerce framework you can self-host to build stores, multi-vendor marketplaces and B2B shops, shipped as MIT-licensed Docker images.

0 comments