ben
/
fosspay
1
0
Fork 1
Code Issues Pull Requests Releases Wiki Activity
my donation page https://donate.bhh.sh
41 Commits 1 Branch 0 Tags 225 KiB
HTML 48.9%
Python 43.8%
JavaScript 6.4%
Makefile 0.9%
Go to file
Drew DeVault 0f628d23fc Add goals and Patreon integration 2017-12-09 11:48:56 -05:00
_static Flesh out donation page 2015-09-05 21:30:52 -04:00
contrib Touch up README 2015-09-06 21:21:52 -04:00
emails Add cronjob for monthly donations 2015-09-06 21:44:46 -04:00
fosspay Add goals and Patreon integration 2017-12-09 11:48:56 -05:00
scripts Wire up the donation cancel button 2015-09-06 16:37:25 -04:00
templates Add goals and Patreon integration 2017-12-09 11:48:56 -05:00
.gitignore Initial commit 2015-09-04 22:51:20 -04:00
LICENSE Initial commit 2015-09-04 22:51:20 -04:00
Makefile Flesh out donation page 2015-09-05 21:30:52 -04:00
README.md Simplify and update README 2017-12-07 13:04:24 -05:00
app.py Initial commit 2015-09-04 22:51:20 -04:00
config.ini.example Add goals and Patreon integration 2017-12-09 11:48:56 -05:00
cronjob.py Track total payments on any donation 2016-07-04 16:29:54 -04:00
requirements.txt Add {{root}} to form actions 2015-09-06 17:59:29 -04:00

README.md

fosspay Donate with fosspay

Donation collection for FOSS groups and individuals.

  • Supports one-time and monthly donations
  • Process cards with Stripe - also supports Bitcoin
  • 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 irc.freenode.net 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

Installation

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 git://github.com/SirCmpwn/fosspay.git
cd fosspay

Install the Python packages:

sudo pip3 install -r requirements.txt

Compile the static assets:

make

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:

python3 app.py

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

Deployment

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.