1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
|
---
title: "Fosspay"
tags: ['service']
icon: 'devault.jpg'
short_desc: "A self-hosted payment and donation gateway interfaced with Stripe."
date: 2022-06-30
---
[Fosspay](https://sr.ht/~sircmpwn/fosspay/) is a free-software web frontend for receiving donations and
subscriptions, similar to Patreon or Liberapay, but which can be hosted
on your own server. It can also interface with Patreon or Github
Sponsors to aggregate all your donations.
## Stripe Setup
Fosspay uses [Stripe](https://stripe.com) as a payment processor. You first must go to [their website](https://stripe.com) and create an account.
Once you set everything up, you can go to [https://dashboard.stripe.com/account/apikeys](https://dashboard.stripe.com/account/apikeys) and get your "Publishable Key" and "Secret Key" which will be all you need to set up Fosspay.
<aside>
### Note on Free Software
Stripe is perhaps the best way to transact in the legacy financial system
online, but you are still not using free and privacy respecting software.
Fosspay is an open source payment gateway, but it still connects to Stripe.
The only way to transact value over the internet on all free software is
[crypto-currency](/monero/).
</aside>
## Dependencies
We will need git, postgres and the ability to make a python virtual
environment:
```sh
apt install git python3-venv python3-dev postgresql libpq-dev
```
## Download and Installation
We will download fosspay to `/var/www/fosspay/`. This directory will
also serve as our virtual environement.
```sh
git clone https://git.sr.ht/~sircmpwn/fosspay /var/www/fosspay
python3 -m venv /var/www/fosspay
```
Activate the python environment with the command below, then we will
install the dependencies.
```sh
source /var/www/fosspay/bin/activate
cd /var/www/fosspay
pip install -r requirements.txt
```
Be sure you are still in `/var/www/fosspay`, then we will build the
package and create the configuration file.
```sh
make
cp config.ini.example config.ini
```
## Create a Database
Fosspay uses a PostgreSQL database to store donation information, so
let\'s create a database and user for it.
First, become the `postgres` user and run the `psql` command:
```sh
su postgres
psql
```
We will create a database named `fosspay` controled by a user named
`fosspay` (also identified by a a password `fosspay`).
```sql
create database fosspay ;
create user fosspay with encrypted password 'fosspay' ;
grant all privileges on database fosspay to fosspay ;
\q
```
Note that if you want to use a different username or password for
whatever reason, change them in the command above, but also in the
`connection-string` variable in the configuration file.
## Configuration
Now open up `/var/www/fosspay/config.ini` and we will set things up.
Here are a list of things to edit.
- `domain` should be set to `{{<hl>}}donate.example.org{{</hl>}}`, with your domain.
- `protocol` can be set to `https`.
- Get or create an email account to use as a mailer and add the account/server
information to the email settings.
- Add your public and secret Stripe keys to the information.
- Change the `connection-string` to
`postgresql://fosspay:fosspay@localhost/fosspay` as set up above.
**An important note:** mail ports *must* be opened on the server you\'re using,
or else Fosspay will silently fail to send mails when someone tries to donate
or reset their password. You do not have to run a mail server on the same
server as Fosspay, but either way, mail submission ports must be opened. This
usually requires contacting your VPS provider and requesting it from them.
Aside from this, any error in the email setup will cause Fosspay to crash
silently.
### Optional Integration with Patreon, Github, Liberapay
Note that if you have a previous Patreon, Github Sponsors or Liberapay
account, you can create an access token for Fosspay, so that you can
display your income from those sources along side Fosspay monthly
donations.
For Liberapay, you only need to include your username. You must create a
[Github access token](https://github.com/settings/tokens) with the
\"user\" access to interface with it, and you have to add several
[Patreon client
parameters](https://www.patreon.com/portal/registration/register-clients)
for it.
## Nginx configuration
Fosspay runs on port 5000, so we can have Nginx show the site. Create an
Nginx configuration file modeled as below:
```nginx
server {
listen 80 ;
listen [::]:80 ;
server_name {{<hl>}}donate.example.org{{</hl>}} ;
location / {
proxy_pass http://localhost:5000 ;
}
}
```
After that, [remember to get HTTPS for the subdomain!](/basic/certbot)
HTTPS is absolutely required for using Stripe as a payment processor.
## Systemd File
We can now create a systemd service file for Fosspay. Create a file in
`/etc/systemd/system/fosspay.service` as below:
```systemd
[Unit]
Description=fosspay website
Wants=network.target
Wants=postgresql.target
Before=network.target
Before=postgresql.target
[Service]
Type=simple
WorkingDirectory=/var/www/fosspay
VIRTUAL_ENV=/var/www/fosspay
Environment=PATH=$VIRTUAL_ENV/bin:$PATH
ExecStart=/var/www/fosspay/bin/gunicorn app:app -b 127.0.0.1:5000
ExecStop=/var/www/fosspay/bin/gunicorn
[Install]
WantedBy=multi-user.target
```
Note that for safety, we are running fosspay through `gunicorn` in our
virtual environment.
We can now run `systemctl start fosspay` to start the service, and it
should appear at the URL you designated above.
## Customizing the Page
Within `/var/www/fosspay/templates`, there are various files that you
can change to add text and other features to the page. The main file is
`summary.html`, where you can add a description and other information
that will appear. Restart the service after updating files to make
changes live.
|
