See the live site at topology.jdabbs.com.
N.B. There is a rewrite in progress - aimed at splitting out a Servant-based API from a more robust and featureful React frontend, and being in a position to support new auth schemes after Persona shuts down. Progress is halting, but the new version will certainly land by November (as that's end of life for Persona).
I would love bug reports and feature requests. Feel free to submit those in the GitHub issues.
If you'd like to contribute code, open up a pull request. I'll review it, merge it in, and push it live once it's good to go.
There are two options for getting a version of the site running locally. In either case, get in touch if you'd like a data set to test against.
You will need to create a settings file at
config/settings.yml - refer to
config/settings.yml.example for an example. Be sure the port declared there is actually the port in use (3000 is the default).
Before you begin, you will need to install the Haskell platform. Cabal should have at least version 1.18 (to use sandboxes). You may have to update Cabal using Cabal and change the link to the newer version:
$ cabal update $ cabal install cabal cabal-install $ sudo mv /usr/bin/cabal /usr/bin/cabal-old $ sudo ln -s ~/.cabal/bin/cabal /usr/bin/
You will need to make sure that the database specified in
config/ actually exists - either by installing Postgres and creating a user and a database, or by changing the database settings to suit your local environment. Installing postgres for the first time can be challenging: you may want to edit
pg_hba.conf after setting up your role (account) as superuser before you can use something like
createuser -d -r -p 5432 pi_base --password, see the postgresql documentation on database roles. The password that is expected can be changed in
Initialize a Cabal sandbox, install pi-base and its dependencies and run a yesod development server (auto-reloading upon changes to the code) with:
$ cabal sandbox init $ cabal install $ yesod devel
Note that the first install may take a while.
For debugging, it can be helpful to empty the database. This can be achieved with the following:
$ dropdb pi_base_dev --port=5432 --username=pi_base $ createdb pi_base_dev --port=5432 --username=pi_base
Become admin in pi-base
After you have logged in in the pi-base web application, you can promote yourself to an admin account (only) by manually editing the database. Assuming you have user id 1 in the database, you can do this with psql:
$ psql --username=pi_base --dbname=pi_base_dev -c "UPDATE remote_users SET admin = True WHERE id = 1;"
You may prefer to develop against a Vagrant box. If so, be sure you have Vagrant installed and do:
locally $ vagrant up && vagrant ssh vagrant $ sudo su vagrant $ cd /vagrant && PATH=$HOME/.cabal/bin:$PATH yesod devel
Note that the included Vagrantfile uses some Virtualbox-specific hooks to increase the available memory. If you are using a different provider and processes are getting killed (which may happen - old versions of cabal can be especially memory heavy), you may need to include similar log to up your vm's memory.
The production site is running under Keter. At some point, we should codify how to spin up a prod / build server. For now you get these notes:
- General security hardening - disable root, password login, fail2ban, change ports, firewall, updates, etc.
- Install and configure keter, start upstart job
- Configure periodic postgres backups
- Configure some sort of monitoring (?)
Use the keter standard
scp pi-base.keter ...:/opts/keter/incoming to deploy.
Building for Deployment
Assuming you have a docker machine set up
docker-compose start keter should build a keter package.