Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

First download the clowder docker-compose file,  https://opensource.ncsa.illinois.edu/bitbucket/projects/CATS/repos/clowder/raw/github.com/clowder-framework/clowder/blob/master/docker-compose.yml. This file should allow you to get a complete docker environment up and running, including some extractors (audio, video, image, pdf). You do not need to make any changes to the docker-compose file, if you want to secure the system more, you can disable the ports used for rabbitmq, mongo and elasticsearch. We have left them open for developers but they will be mapped to random ports (see docker tips). The only port that needs to be mapped is port 9000 of clowder, which in the docker-compose file is mapped to port 9000 in the docker machine.

...

There are many configuration values that you can override, for example the default admin email address. You can do this in a few different ways

...

To do this you will need to edit the custom.conf file used by clowder. This file is located in the clowder-custom volume. You can either change the content of this folder directly (use docker volume inspect clowder_clowder_1 to find the actual location on disk), or you can exec into the running docker container (docker exec -ti clowder_clowder_1 /bin/bash) and goto the folder /home/clowder/custom. You can edit the custom.conf file to fit your needs. Once you finish making the changes you can exit the container using exit, this will not stop the container. You will need to restart the clowder container, which can be done using docker restart clowder_clowder_1.

Another way is to make any changes before you start the full stack. You can run just the clowder instance and make changes using: `docker-compose run --no-deps clowder /bin/bash` this will start just the clowder container and give you a bash prompt. You can make changes to the custom.conf and play.plugins and exit. If you now start the full stack it will use these updated changes when starting clowder.

A list of all values that can be changed can be found at at https://opensource.ncsa.illinois.edu/bitbucket/projects/CATS/repos/clowder/browse/github.com/clowder-framework/clowder/blob/master/conf/application.conf.

Docker Tips

When starting clowder using docker-compose up, the containers will be named <folder name>_<service>_1, for example if you download the docker-compose file in your clowder folder, the clowder container will be called clowder_clowder_1.

...

To see the logfiles for a specific container, especially useful if you started docker-compose up -d, you can use docker logs <container name>, for example to see the log files for clowder you can use docker logs -f clowder_clowder_1 (this will follow the log file, to stop this you need to press ctrl -c).

To see the volumes and the actual location on disk you can use docker volume ls, as well as docker volume inspect. Both windows and mac will use a virtual machine, so the volumes will be located in that virtual machine.

If you run clowder using docker-compose up, you will have all the log files in the console where you started clowder. If you use docker-compose up -d, all containers will run in the background. You can 

...