diff --git a/docs/installing.rst b/docs/installing.rst index e2c87c1..2000671 100644 --- a/docs/installing.rst +++ b/docs/installing.rst @@ -1,2 +1,46 @@ Installing ========== + +Docker +------ + +It is recommended to install Humulus using docker. You can run a container for +CouchDB and a container for Humulus on the same machine. Docker makes it easy +to update to the latest version. + +The following commands can be ran to setup Humulus in docker: + +:: + + # Create a network for all of this to run under + sudo docker network create humulus + + # Create a CouchDB container with admin user credentials admin/password + sudo docker run -d -e COUCHDB_USER=admin -e COUCHDB_PASSWORD=password --network humulus --name couchdb couchdb:latest + # Create the databases needed to run in single server mode + sudo docker exec -it couchdb /usr/bin/curl -X PUT http://admin:password@127.0.0.1:5984/_users + sudo docker exec -it couchdb /usr/bin/curl -X PUT http://admin:password@127.0.0.1:5984/_replicator + sudo docker exec -it couchdb /usr/bin/curl -X PUT http://admin:password@127.0.0.1:5984/_global_changes + + # Create a config file for humulus + sudo mkdir -p /opt/humulus + sudo tee /opt/humulus/settings.py <