SolidarityTools

Run your own co-op marketplace

Deliveries, rides and repairs — booked through a platform the co-op owns, instead of renting one that takes a cut of every job. The code, the deployment guide, and the rules for running it as a co-op.

Every small co-op that tries to take bookings online runs into the same wall. A commercial marketplace wants 15-30% of every job, keeps the customer relationships, and gets to change its terms whenever it likes. Hand over your members' earnings and your customer list, and what is left is not really a co-op any more — it is a franchise.

This is the alternative: a small self-hosted booking platform you install on your own server. Members see the jobs, offer to do them, and the money is split by a rule the membership votes on. Nobody takes a commission for owning the software, because nobody owns it.

What it is in one paragraph. A booking and payout-record system for a worker-owned co-op: customers request a job, members offer a price, a dispatcher or the requester awards it, the work gets marked done, and the ledger splits the money between the member who did the job, the co-op's own fund, and a reserve for hosting and insurance. Every member can read every line of the books, and changing the split takes a vote — not an admin's decision.

Download: co-op marketplace starter kit 0.1.1

coop-marketplace-starter-kit-0.1.1.zip — 60 KiB, 24 files, no sign-up, no email required.

SHA-256: a52d04e1ac702777b43972eb3fe85a08a9b7682a7acf7ef59634452abbb48a07
Licence: code AGPL-3.0-or-later, written guides CC BY-SA 4.0. Free forever. See Licence and support below.

1. What is in the download

PartWhat it does
The applicationThe booking platform itself: member accounts, job intake, offers, awarding, the ledger, and voting. About 1,500 lines of readable code.
run.pyOne command to create the co-op, serve the site, add members and take backups.
Deployment guideEmpty server to live site: the service file, HTTPS, firewall, backups, restore, upgrades, a go-live checklist and the real yearly costs.
Operating guideThe part the software cannot do for you: payouts, rotating dispatchers, disputes, onboarding, deleting customer details, weekly numbers.
53 end-to-end testsOne command proves the whole thing works on your own machine before you trust it with real bookings.
Demo co-opA throwaway co-op with members and live sample jobs, so the group can click through it in ten minutes and decide if it is right for them.
Deploy kitsystemd unit, Caddy config for automatic HTTPS, Dockerfile and docker-compose — use whichever your co-op already understands.

2. Three trades, ready to go

The kit ships with the intake forms and job states for the three things small co-ops actually run:

VerticalWhat the customer is asked
DeliveryCollect from, deliver to, how many parcels, weight, time window, anything fragile or chilled, access notes.
RidesPick up, take to, passengers, date and time, return trip, accessibility or luggage needs.
RepairsWhat it is, what is wrong, where it is, whether it can be brought in, whether parts may be fitted, preferred window.

Adding cleaning, gardening, tutoring or a meals round is one small addition to a single file. Nothing else in the system changes.

3. What makes it a co-op platform and not a commission app

  1. The split is a rule the members vote on, not a fee an owner charges. The defaults are 85% to the member who did the work, 10% to the co-op's fund, 5% to a reserve for hosting and insurance. Any member can propose different numbers; it passes on a majority with a quorum. The software refuses to let an administrator quietly edit the split — that route is closed on purpose.
  2. One member, one vote. Enforced in the database: you cannot vote twice, and a handful of people cannot pass something for everyone because the quorum has to be met.
  3. The books are open. Every member sees every line: who was paid what, what went to the fund, what went to the reserve. There is no hidden take rate to discover later.
  4. Members choose their work. Offers come from members and are awarded by the requester or a dispatcher. There is no surge pricing, no acceptance-rate score punishing people for saying no, and no algorithm deciding who deserves the next job.
  5. The money stays in the co-op's own bank account. The platform records who is owed what; the treasurer pays out by transfer. No third party sits between a member and their earnings.

4. What it deliberately does not do

Worth knowing before you download it, because a co-op that expects these features and does not find them will be disappointed — and one that adds them without thinking will recreate the platform it was trying to escape.

5. What you need

ItemNotes
A small serverEUR 4-5 a month, 1 GB RAM is plenty. A Raspberry Pi on the co-op's broadband works too.
A domainEUR 10-15 a year, e.g. market.yourcoop.ie.
Python 3.9 or newerAlready on every modern server. Nothing to install — no pip, no Node, no Docker required, no dependency tree to rot.
Half an hourMost of it waiting for DNS to propagate.
Two peopleOne admin, and a second person who can get into the server. Never run a co-op with a single keyholder.
Total platform costAbout EUR 60-85 a year, and the fee does not grow when the co-op's turnover does.

6. Installing it, in short

The deployment guide has the full version, including the security settings and the backup schedule. The short version:

python3 run.py init --db coopmarket.db \
    --coop-name "Riverside Deliveries Co-op" \
    --admin-email chair@example.org \
    --admin-password 'a-long-passphrase'

python3 run.py serve --db coopmarket.db --host 127.0.0.1 --port 8080

Then a service file so it starts with the server, and a web server in front of it for HTTPS. Both are provided and configured for you; Caddy gets the certificate automatically and renews it. The guide also covers the firewall, the backup, and — the step people skip — actually testing a restore once, before it matters.

Check it works before you trust it. The download includes 53 end-to-end checks that run against a live copy of the software on your own machine: a customer request with no account, invite-only registration, offers, awarding, a refused vote, a refused admin edit of the split, the money splitting correctly when the price does not divide evenly, and a passed vote taking effect on the very next job. One command, about ten seconds, no data leaves your computer.

7. Running it as a co-op, not just as software

The download includes a plain-English operating guide covering the things that decide whether this works as a co-op:

8. Licence and support

The code is AGPL-3.0-or-later; the written guides are CC BY-SA 4.0. Use it, change it, run it for as many co-ops as you like, put your co-op's name on it, fork it. The one condition worth knowing: if you run a modified version as a network service, publish your changes, so the next co-op gets them. That is the software equivalent of the argument on our commons licences page — improvements to a shared tool belong back in the commons.

There is no paid tier and no support subscription. No sign-up, no email capture, no "pro" licence. The deployment guide is the support, the tests are how you verify a change, and the code is small enough to read in an evening on purpose — a co-op should not need a vendor to understand its own booking system. If someone offers to do your setup as paid work, that is a fair arrangement between you; the software itself is not the thing being sold.

9. Before you rely on this

This kit is a starting point, not a finished institutional system, and it is not legal, financial or tax advice. Before it carries real payments to real people, your co-op should have: a written rule for how payouts are authorised, a decided retention period for customer details, insurance or a clear position on liability for a delivery that goes wrong, and a second person who can restore the server from a backup. The operating guide is written to make those decisions easy to hold at a meeting — it does not make them for you.

Same as everything else here: check it against your own circumstances, and get a professional to look at anything involving money that is not yours.

How to check this page is honest: the download is a SHA-256 hash above, the tests are in the download and run offline, and there is no tracking on this site. Nothing here phones home.

Free to copy, adapt and pass on.