- Clone this repo and cd into it
- Copy
docker-compose-template.yml
todocker-compose.yml
- Update the
MYSQL_ROOT_PASSWORD
indocker-compose.yml
- Create file
global_envars.cfg
with the following (updating credntials):MYSQL_DATABASE=erambadb MYSQL_USER=eramba MYSQL_PASSWORD=changemetoo
- Run
sh ./prep_host_directory_struct.sh
- this creates /data/eramba/<several_dirs>, if you want to change the host data dir, ensure you update the docker-compose.yml also - Run
docker-compose up -d
- this will start containers in the background - On first time start, you need to create the database tables, to do this run
sh ./create_db_tables.sh
- You should now be able to load the initial login page via a browser, i.e.: http://localhost/
Eramba has 3 cron/timer jobs, hourly, daily and yearly.
As many docker users will be using coreos / operating systems without cron tabs, systemd jobs and timers can be used to run these jobs.
Assuming you retain the standard directory paths and container names, you can simply run sudo ./deploy_cron_services.sh
- look at the contents of that script and the cron
directory if experiencing issues and try running the eramba_test.sh script.
These jobs use the cli cron type (so in the settings of the web interface ensure CLI is chosen, not Web for cron jobs).
By default your deployment will start with c2.8.1 of eramba community.
Periodically eramba.org will releae updates which can be applied via the setting page in the web app.
If you do upgrade then the app container is lost, your DB will be stuck on a new version (say c2.8.2) but the new app container will start back at 2.8.1 (which wont work well if there were schema changes to the database between those releases).
If that occurs specify the desired version of the container in your docker-compose.yml, e.g.: image: markz0r/eramba-app
becomes image: markz0r/eramba-app:c282
; this is dependent on the maintainer completing a new docker image in a timely fashion.