selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Codeberg
flohmarkt logo

Self-host flohmarkt

0.6.1

Federated fediverse platform for local classified ads

BetaOpen SourceAGPL-3.0
Updated2 years ago
Setup difficultyModerate
Port
8000 (Web application (uvicorn) HTTP port)
Requires
CouchDB
Docker
codeberg.org/flohmarkt/flohmarkt
Install with Docker Compose
flohmarkt screenshot 1

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.

flohmarkt alternatives

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

docker-compose binary
Environment variables
FLOHMARKT_VERSION, LANG
  1. 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`.

How to configure flohmarkt

  • FLOHMARKT_INSTANCE_NAMEInstance name.
  • FLOHMARKT_EXTERNAL_URLPublic URL the flohmarkt is reachable at.
  • FLOHMARKT_DB_HOSTdatabaseDatabase host.
  • FLOHMARKT_DB_PORT5984Database port.
  • FLOHMARKT_DB_NAMEflohmarktDatabase name.

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

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…