Docker repository for deploying Farnsworth
Install Docker and Docker Compose
Follow these instructions to install Docker and Docker Compose on your system of choice:
Note that most commands below require access to root in order to communicate
with the Docker daemon.
sudo has been added in front of commands whever
Bring up your Farnsworth deployment using docker-compose:
$ cp docker-compose.yml.example docker-compose.yml $ $EDITOR docker-compose.yml $ cp settings/house_settings.py.example settings/house_settings.py $ $EDITOR settings/house_settings.py $ sudo docker-compose up -d
You can then add some initial content to the site via:
$ sudo docker-compose run web /opt/apps/farnsworth/farnsworth/pre_fill.py --managers --requests --workshift
(This may take a while as it needs to build the docker images the first time)
You can pull updates from the official Farnsworth repository without restarting your container by running the following command:
$ sudo bin/update
Backups require the postgresql package, run them with the following command:
$ sudo bin/backup "backup-<house>-$(date +%F).dump"
Backups can be restored with the following command:
$ sudo bin/restore "backup-<house>-<date>.dump"
To enable SSL, modify your docker-compose.yml file to enable SSL and mount a volume containing the SSL keys:
web: ports: - "80:80" - "443:443" ... environment: - ENABLE_SSL=yes ... volumes: - keys/:/opt/apps/keys
keys/private.key for your public and
private key respectively.
If your host machine is running CentOS or RHEL, or is otherwise running SELinux you will need to give docker permission to read the folders containing the settings and optionally the ssl keys.
$ sudo chcon -Rt svirt_sandbox_file_t settings keys pg_data