Running with Docker
Running CIMonitor with docker is the easiest way to get started quickly. There are some tips and trick you can use with Docker which we will explain below.
Starting the container
Running the command below will start CIMonitor on localhost:3030.
docker run \
--publish 3030:3030 \
--detach \
--restart unless-stopped \
--name CIMonitor \
--volume $(pwd)/storage:/CIMonitor/storage \
cimonitor/server:latest
If you want to override some of the environment variables, you need to add --env
to your
command. So if you want to change the running port for example, you add --env PORT 80 --publish 80:80
to the command.
Note, a storage folder will be created from the location you execute the run command. The storage folder is used to persist server settings and saved statuses.
Stopping the container
Since we've named the container, stopping the CIMonitor container is as easy as running docker stop CIMonitor
.
If you haven't named your container, run docker ps
and find the container id for the image cimonitor/server
. Then you
can run docker stop <container_id>
.
Updating the container
Updating CIMonitor when running docker requires you to pull the latest container with docker, then restarting your running CIMonitor to use the latest version. When you've named your container you can do this very easily with:
docker pull cimonitor/server:latest && docker restart CIMonitor
If you're running a specific version instead of latest, stop your CIMonitor instance, and run the run command again
(as described on the top of this page) with the new cimonitor/server:<version>
reference.