Currently, the Donatinator can be hosted on various different PaaS solutions such as Heroku or OpenShift, run on your own server, or run through a container orchestration framework such as Kubernetes (coming soon) or Nomad (coming soon).


The first (and only) thing you need is a Stripe account, your API keys (publishable key and secret key), and the signing secret from your webhook configuration.


There are three ways you can set up your app on Heroku. This may depend on how technical you are, or whether you prefer a one-click install, clicking around the Heroku Dashboard, or doing everything via the command line (or a combination of all these).

Via the One Click Install


Via the Heroku Dashboard

Firstly, head into your Heroku Dashboard and create a new app.

From here, you set the following environment variables in the settings tab:

For this last config var, you also need to provision a database on the 'Resources' page of your app, by clicking on 'Add-ons' and searching for Heroku Postgres. For now, just choose a HobbyDev - Free plan.

Once you've done the above, you need to clone the Donatinator code, set up the remote (use your own app name instead of furry-goat-123), and finally push to Heroku:

$ git clone
$ cd donatinator
$ heroku git:remote -a furry-goat-123
$ git push heroku master

You may need to read the Git article on the Heroku docs for more information.

Please let us know how you get on with these instructions.


You can perform most of the above using the command line. ToDo.