diff --git a/README.md b/README.md index 955a0e10..26b61901 100644 --- a/README.md +++ b/README.md @@ -1,50 +1,51 @@ ## Quickstart Instructions to try it out * Make sure you have docker and docker-compose available. * Change to the base directory of this repository. * Run 'HOST=kolab.local ADMIN_PASSWORD="simple123" bin/configure.sh config.prod' to configure this deployment. * Run 'env ADMIN_PASSWORD="simple123" bin/deploy.sh' to start the deployment. * Add an /etc/hosts entry "127.0.0.1 kolab.local" * navigate to https://kolab.local * login as "admin@kolab.local" with password "simple123" (or whatever you have set), and create your users. # Customization To customize the installation, copy config.prod and adjust to your liking. You can then install the configuration using 'bin/configure.sh $YOURCONFIG', and afterwards 'bin/deploy.sh' again. Please note that bin/deploy.sh will remove any existing data. ## Alternative configurations Everything but config.prod is for development or demo purposes: -* config.dev: Run only dependencies in docker with ports exposed, and expect kolab4 to be run locally. -* config.docker-dev: A development environment with everything running in docker. Includes a cyrus-murder. -* config.demo: A docker environment with demo data included. * config.prod: A docker environment with just an admin account prepared. A starting point for a production environment. +* config.demo: A docker environment with demo data included. +* config.docker-dev: A development environment with everything running in docker. Includes a cyrus-murder. Don't use unless you know what you're doing. +* config.host-dev: Run only dependencies in docker with ports exposed, and expect kolab4 to be run locally. Don't use unless you know what you're doing. +* config.legacy: A docker environment that includes ldap and other legacy components. Don't use unless you know what you're doing. # Use the ansible setup The ansible/ directory contains setup scripts to setup a fresh Fedora system with a kolab deployment. Modify the Makefile with the required variables and then execute `make setup`. This will configure the remote system and execute the above steps. ### Update To update the containers without removing the data: * git pull * Run "bin/update.sh" ### Backup / Restore The "bin/backup.sh" script will stop all containers, snapshot the volumes to the backup/ directory, and restart the containers. "bin/restore.sh" will stop all containers, restore the volumes from tarballs in the backup/ directory, and restart the containers. ### Requirements * docker * openssl