You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Olivier Benz 70beb58339 Fix 'Donate again' 2 years ago
_static Remove CDN and use local files 4 years ago
contrib Merge pull request #16 from Perflyst/remove-cdn 4 years ago
emails yeet pystache 2 years ago
fosspay Fix 'Donate again' 2 years ago
scripts Add invoice.js 5 years ago
templates Add a the missing internal error template 3 years ago
.gitignore Initial commit 8 years ago
LICENSE Initial commit 8 years ago
Makefile have Makefile `cp -r` the _static contents 4 years ago Update README to reflect IRC's move to libera 3 years ago Fix a signal bug on python post 3.8 version 3 years ago
config.ini.example Change example domains to 4 years ago Use the configured currency during the cronjob 4 years ago
invoice Add support for invoices 5 years ago
requirements.txt Update requirements.txt 2 years ago

fosspay Donate with fosspay

Donation collection for FOSS groups and individuals.

  • Supports one-time and monthly donations
  • Process cards with Stripe
  • Flexible and customizable

It works for individuals (like me) and it works for organizations. Expect to spend about an hour or two setting up everything and then you're good to go.

For support, visit #cmpwn on or file a GitHub issue.

Before you start

You will need a number of things set up before you start:

  1. An approved Stripe account
  2. A mail server
  3. A domain name and an SSL certificate
  4. A web server to host fosspay on


Install these things:

  • Python 3
  • pip (python 3)
  • PostgreSQL

You're responsible for setting up PostgreSQL yourself. Prepare a connection string for later.

Clone the git repository on the server that you want to host fosspay on:

git clone
cd fosspay

Install the Python packages:

sudo pip3 install -r requirements.txt

Compile the static assets:


Create a configuration file:

cp config.ini.example config.ini

Edit config.ini to your liking. Then, you can run the following to start up the development server:


Log into http://your-domain:5000, and you will receive further instructions.


Once you have everything configured, you will need to switch from the dev server into something more permanent. Install gunicorn on your server and use the systemd unit provided in contrib/. You will also probably want to run this through nginx instead of directly exposing gunicorn to the web, see contrib/nginx.conf. Neither the nginx configuration or the systemd unit are immediately ready to use - read them and change them to suit your needs.

Using nginx or something like it is necessary for SSL support, and you must serve your site with https for Stripe to work.