Setup

First, install Coldsweat with pip or clone the repository into your installation directory, like explained in the main Readme file.

Configuration settings

Coldsweat to run needs two information:

1. Where to store data. See Peewee's Database URL examples to configure your database of choice.
2. Which secret key to use when generating session cookies to keep web users logged-in. See Flask documentation about secret keys on tips to pick secure values.

Such information can be specified in two ways.

1. Using a configuration file

By adding a config.toml file, using the TOML format. This boils down to write a series of key-value pairs like the example below:

DATABASE_URL="mysql://username:password@example.com:3306/coldsweat"
SECRET_KEY="192b9bdd22ab9ed4d12e236c78afcb9a393ec15f71bbf5dc987d54727823bcbf"

2. Using environment variables

Another approach is using environment variables and assign their values to names prefixed by FLASK_:

export FLASK_DATABASE_URL="mysql://username:password@example.com:3306/coldsweat"
export FLASK_SECRET_KEY="192b9bdd22ab9ed4d12e236c78afcb9a393ec15f71bbf5dc987d54727823bcbf"

Deploy

Please take look at the Deploy page.