# flohmarkt

> A self-hosted, open-source classified-ads web app that shares listings across the fediverse via ActivityPub, linking local communities instead of one big marketplace.

- **Category:** [Marketplace](https://selfhost.directory/marketplace)
- **Licence:** AGPL-3.0
- **Source model:** Open source
- **Latest version:** 0.6.1
- **Author:** grindhold
- **Platforms:** Docker Compose, NixOS, YunoHost, Build from Source
- **Ports:** 8000 (Web application (uvicorn) HTTP port)
- **Requires:** CouchDB
- **Tags:** Notifications, Activitypub, Federation, I18n, Marketplace, Moderation, Fediverse, Couchdb

## Docker images

- [`codeberg.org/flohmarkt/flohmarkt`](https://codeberg.org/flohmarkt/flohmarkt)

## What 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.

## Should you self-host flohmarkt?

flohmarkt scores **56/100** on selfhost.directory ([how scoring works](https://selfhost.directory/scoring)) and ranks **#1 of 3** in [Marketplace](https://selfhost.directory/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](https://selfhost.directory/project/shopclass) (51/100, 114 stars). flohmarkt scores higher overall. [See flohmarkt vs ShopClass side by side.](https://selfhost.directory/compare/flohmarkt-vs-shopclass)

## 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

Requirements: docker-compose binary

Environment variables:

```
FLOHMARKT_VERSION, LANG
```

1. Get the docker files
	```bash
	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
	```

Note: 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.

## flohmarkt alternatives

- [PieFed](https://selfhost.directory/project/piefed): PieFed is an open-source, self-hosted fediverse forum and link aggregator in Python/Flask with topics, polls, community wikis and first-rate moderation tools. (compare: https://selfhost.directory/compare/flohmarkt-vs-piefed)
- [Flus](https://selfhost.directory/project/flus): Flus 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. (compare: https://selfhost.directory/compare/flohmarkt-vs-flus)
- [Mastodon](https://selfhost.directory/project/mastodon): Open-source self-hosted microblogging server that federates over ActivityPub, with chronological timelines, media posts, moderation tools and an OAuth2 REST API. (compare: https://selfhost.directory/compare/flohmarkt-vs-mastodon)
- [PixelFed](https://selfhost.directory/project/pixelfed): A self-hosted, open-source photo and video social network that federates over ActivityPub with albums, stories, direct messages and chronological feeds. (compare: https://selfhost.directory/compare/flohmarkt-vs-pixelfed)
- [Postmarks](https://selfhost.directory/project/postmarks): Postmarks is a self-hosted, open-source bookmarking site connecting to the Fediverse via ActivityPub to interact with Mastodon and other platforms. (compare: https://selfhost.directory/compare/flohmarkt-vs-postmarks)
- [Lemmy](https://selfhost.directory/project/lemmy): Self-hosted, open-source fediverse link aggregator and forum: federated communities, upvotes, threaded comments, mod logs. Built in Rust, deployed via Docker or Ansible. (compare: https://selfhost.directory/compare/flohmarkt-vs-lemmy)
- [mbin](https://selfhost.directory/project/mbin): Self-hosted fediverse platform for content aggregation, voting, discussions and microblogging. Replaces Reddit with ActivityPub federation to Mastodon, Lemmy, PeerTube. (compare: https://selfhost.directory/compare/flohmarkt-vs-mbin)
- [bonfire-app](https://selfhost.directory/project/bonfire-app): Bonfire is a self-hosted framework for creating federated community spaces with modular extensions and granular privacy controls. (compare: https://selfhost.directory/compare/bonfire-app-vs-flohmarkt)

## More in Marketplace

- [Gumroad](https://selfhost.directory/project/gumroad): Gumroad'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.
- [Mobazha](https://selfhost.directory/project/mobazha): Self-hosted open-source P2P commerce platform where sellers own their storefront and data, connecting to shared marketplaces with multi-chain crypto payments.
- [Mobazha Unified](https://selfhost.directory/project/mobazha-unified): Self-hosted, open-source commerce frontend for storefronts, marketplace discovery, checkout, and seller management, connecting to a self-hosted Node for crypto payments.
- [Sharetribe](https://selfhost.directory/project/sharetribe): Sharetribe 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.
- [ShopClass](https://selfhost.directory/project/shopclass): ShopClass is a self-hosted, open-source classifieds platform in PHP for marketplaces, job boards, and property sites with custom fields and paid listings.
- [Shopstr](https://selfhost.directory/project/shopstr): Shopstr is a self-hosted, open-source Nostr marketplace enabling censorship-resistant Bitcoin commerce via Lightning and Cashu with no KYC or platform fees.
- [Spree Commerce](https://selfhost.directory/project/spree-commerce): Self-hosted, open-source headless commerce platform with Store, Admin and Seller REST APIs, typed SDKs, a React admin and a Next.js storefront.
- [Aimeos](https://selfhost.directory/project/aimeos): Laravel shop distribution for online stores, multi-vendor marketplaces and B2B sites; self-hosted and open-source, with JSON REST, GraphQL and MCP APIs.
- [Bagisto](https://selfhost.directory/project/bagisto): Open-source Laravel eCommerce framework you can self-host to build stores, multi-vendor marketplaces and B2B shops, shipped as MIT-licensed Docker images.

## Links

- [Homepage](https://codeberg.org/flohmarkt/flohmarkt)
- [Wiki (documentation)](https://codeberg.org/flohmarkt/flohmarkt/wiki)
- [Service compatibility chart](https://codeberg.org/flohmarkt/flohmarkt/wiki/Service-compatibility-chart)
- [flohmarkt instances list](https://codeberg.org/flohmarkt/flohmarkt/wiki/flohmarkt-instances)
- [YunoHost app](https://apps.yunohost.org/app/flohmarkt)
- [NLnet project page](https://nlnet.nl/project/Flohmarkt)

---
Source: https://selfhost.directory/project/flohmarkt