diff --git a/Readme.md b/Readme.md index 41175d37632a580c40f8b56736c6455901a59539..cc588830e0c6f0375e460bfcfc5ab529b818644e 100644 --- a/Readme.md +++ b/Readme.md @@ -15,9 +15,16 @@ This is a docker-compose setup for [ODK](https://getodk.org) + Most defaults are set according to .env 4. Get the sql `docker-compose exec front cat webapps/ODK\ Aggregate/create_db_and_user.sql` 5. Run `docker-compose exec db psql -U aggregate` and paste SQL from step 4 -6. Run `docker-compose exec front mv webapps/ODK\ Aggregate/ODKAggregate.war webapps/` +6. Run `docker-compose exec front mv webapps/ODK\ Aggregate/ODKAggregate.war webapps/ROOT.war` 7. Restart the docker-compose `docker-compose down; docker-compose up -d` -At this point everything should be configured, go to `http://localhost:8080/ODKAggregate` and finish installation process. +At this point everything should be configured, go to `http://localhost:8080/` and finish installation process. Default password is `aggregate`, username is the one you set in step 2. + +## Use it behing an apache2 proxy + +1. Follow install instruction using a Fully Qualified Domain Name in step 2 instead of `localhost` +2. Copy the odk.conf file to `/etc/apache2/sites-available/odk.conf` and adapt it +3. `a2ensite odk.conf && apache2ctl graceful` +3. **Recommended** switch to HTTPS using [certbot](https://certbot.eff.org/) diff --git a/odk.conf b/odk.conf new file mode 100644 index 0000000000000000000000000000000000000000..b99472ced5f0009808451e9234a054840a74539c --- /dev/null +++ b/odk.conf @@ -0,0 +1,12 @@ +<VirtualHost *:80> + ServerName <FQDN> + + ProxyRequests On + ProxyPreserveHost on + + ProxyPass / http://127.0.0.1:8080/ + ProxyPassReverse / http://127.0.0.1:8080/ + + CustomLog ${APACHE_LOG_DIR}/<FQDN>.access.log combined + ErrorLog ${APACHE_LOG_DIR}/<FQDN>.error.log +</VirtualHost>