First, install Docker on your operating system. On Debian this can be achieved by apt-get install docker.io.
Note: For some reason Docker has problems with DNS resolution on my system. This can be alleviated by editing /etc/default/docker and uncommenting the DOCKER_OPTS line. Restart the Docker daemon afterwards: service docker restart.
This grabs the release version (master branch), which is recommended. Use :latest if you want the devel version.
export HP_VERSION=breunigs/hipsterpizza:release
docker pull $HP_VERSION
You’ll have two containers running: One which runs the actual HipsterPizza software and an additional one to hold the data. This way you can throw away the “runner” when updating, while preserving saved orders and other data.
docker run -d --name hipsterpizza_data -v /app/db $HP_VERSION echo 'Data Only'
docker run -d --name hipsterpizza_runner --volumes-from hipsterpizza_data -p 10002:10002 $HP_VERSION
This will make HipsterPizza available on your machine on http://localhost:10002.
docker stop hipsterpizza_runner
docker start hipsterpizza_runner
docker restart hipsterpizza_runner
# start a shell to inspect the docker container while it is running:
docker exec -it hipsterpizza_runner bash
If you want to change configuration (e.g. editing config/fax.yml) store the file somewhere on your host system. Next run the following command:
docker exec -it hipsterpizza_runner bash -c 'cat > /app/config/fax.yml' < my_config/fax.yml
It’s a bit clunky, but docker cp does not allow files to be copied to the container yet. If you accidentally overwrite important files and the container exits immediately start fresh – this works just like described in the “Upgrading” section. Use this to see what crashes HipsterPizza: docker start -ai hipsterpizza_runner.
docker pull $HP_VERSION
docker rm hipsterpizza_runner
docker run -d --name hipsterpizza_runner --volumes-from hipsterpizza_data -p 10002:10002 $HP_VERSION
If you had modified files before, execute the copy statements again. Patches to improve the retention of config files are welcome.
Please continue with the normal guide starting at webserver integration.
You can also build your own Docker image from HipsterPizza’s source. Below are the basic steps need to do this. Please refer to Docker’s documentation for everything else:
git clone git://github.com/breunigs/hipsterpizza
cd hipsterpizza
# (make some changes)
docker build --tag MYPIZZA .
docker run -d --name hipsterpizza_data -v /app/db MYPIZZA echo 'HipsterPizza Data Only'
docker run -d --name hipsterpizza_runner --volumes-from hipsterpizza_data -p 10002:10002 MYPIZZA