Run It Locally
Please note, the following instructions have only been tested on the Debian Stretch OS.
You'll need to run an RQLite database first:
$ apt update && apt install -y make $ make install-rqlite $ make rqlited
Then get Pipenv and run the development server with:
$ pipenv install --dev --three $ pipenv run devserver
The local development web server will now be available.
If you need to check the database contents, run:
$ make rqlite
And then run
.help for which commands are available.
$ pipenv run tox
Refer to the tox.ini for configuration options.
See ansible/README.md for this.
The XPPL is made up of a few parts:
- The Flask application and it's dependencies.
- The RQLite database.
- The Syncthing integration for uploads.
- The Nginx reverse proxy.
- The Let's Encrypt web certificates.
On the varia.zone machine, you can check the running services with:
$ sudo supervisorctl status all # check all services $ sudo supervisorctl stop xppl:* # stop all XPPL services $ sudo supervisorctl start xppl:* # start all XPPL services
You can also view the error logs with:
$ sudo supervisorctl tail xppl:xppl-flask stderr $ sudo supervisorctl tail xppl:xppl-rqlite stderr
/var/xppl/xppl/uploads folder is managed by the Varia Syncthing UI.
The RQLite database is located at
/var/xppl/rqlite/node.1. No cluster is configured.
No backups are configured right now.