How to use this image
When a new container is created from the HCL Domino Docker image, it takes environment variables into account for auto-configuring the Domino server. Details on how to use those variables can be found here
The Domino data directory needs to be a persistent volume. On Docker it will be automatically created. You can also use an existing volume. All volume types your container infrastructure supports can be used.
Creating a new container from an image manually
Run a new Domino server with the configuration details of your choice. Make sure to specify the base image name at the very end of this command.
Note: For values containing blanks use quotes around the whole env parameter!
docker run -it -d \
-e SetupAutoConfigure=1 \
-e SERVERSETUP_SERVER_TYPE=first \
-e SERVERSETUP_ADMIN_FIRSTNAME=John \
-e SERVERSETUP_ADMIN_LASTNAME=Doe \
-e SERVERSETUP_ADMIN_PASSWORD=domino4ever \
-e SERVERSETUP_ADMIN_IDFILEPATH=admin.id \
-e SERVERSETUP_ORG_CERTIFIERPASSWORD=domino4ever \
-e SERVERSETUP_SERVER_DOMAINNAME=DominoDemo \
-e SERVERSETUP_ORG_ORGNAME=Domino-Demo \
-e SERVERSETUP_SERVER_NAME=domino-demo-v12 \
-e SERVERSETUP_NETWORK_HOSTNAME=domino.acme.com \
-h domino.acme.com \
-p 80:80 \
-p 1352:1352 \
-v dominodata_demo:/local/notesdata \
--stop-timeout=60 \
--cap-add=SYS_PTRACE \
--cap-add=NET_BIND_SERVICE \
--name domino12 \
hclcom/domino:latest
Runtime configuration
During docker run
you can setup a volume that mounts property files into /local/notesdata
Stopping the Application Server gracefully
Stopping a Domino server takes longer than the time a Docker server would expect by default (10 seconds), the recommended way is to add the parameter --stop-timeout
already when starting the container. If the container was started with the parameter --stop-timeout=
then you may stop the container using the following command:
docker stop <container-name>
If the container was started without specifying the parameter --stop-timeout=
then use the following command to stop the container gracefully
docker stop --time=<timeout> <container-name>
Example:
docker stop --time=60 test