This page assumes that you have decided to start UnPoller using
The setup detailed below will install containers for UnPoller, Grafana and InfluxDB
Make sure you have set up a user on your controller for UnPoller.
UnPoller's Docker container can be configured in two ways:
- Using environment variables.
- Using a configuration file.
Which to use is a matter of personal choice. The environmental path has the advantage that all settings are in one place (albeit a hidden file, and one where all information is available to all containers). The config file method has the advantage that UnPoller specific settings can be saved in the same shared Docker folder as the rest of the app's data.
There is a detailed description of the configuration parameters on the Application Configuration page.
Both of the alternatives described here will pull containers not just for UnPoller, but also for InfluxDB and Grafana. If you wish to use existing instances then amend the files as necessary.
The easiest way to pass environment variables via
docker-compose is to have a
.env in the same folder as the
docker-compose yaml file
Files beginning with a period
. are generally hidden. You may need to use
ls -a to find the
- Copy the example environment file
- Edit it as necessary (in particular ensure that
- Save it as
.envin the same folder as your
docker-compose.yml(if you have one; if not see below)
Download the example
docker-compose.yml and add it to your existing one (if you have one; if not just make sure it is
saved in the same folder as the
This example is advanced, for demonstration only, and not recommend for newbies.
Advanced Prometheus Example
The following example illustrates launching Grafana, Prometheus and UnPoller with docker compose.
This does not utilize a
.env file nor a configuration file and instead puts all the env variables
directly into the docker-compose file.
This still requires a Prometheus configuration to scrape Poller.
This is a community provided example.
Alternatively, if you choose to use a configuration file:
- Copy the example config file
- Edit it as necessary (in particular ensure that the
passvariables are set)
- In the
url = "http://127.0.0.1:8086"to become
url = "http://THE_IP_OF_YOUR_DOCKER_HOST:8086"
- Save it as
unpoller.confin the local location you use for Docker storage in a folder called
When configuring make sure that you do not include
:8443 on the url of the controller
if you are using
unifios. Those are: UDM Pro, UDM, UXG, or CkoudKey with recent firmware.
Add the following to your
docker-compose.yml after replacing
to a local location for Docker storage.
Details of tags available are described in Docker - FAQ.
Whichever configuration method you chose, this is how you start the contianers:
If everything is working, after a few minutes you should see like likes this:
If you don't see these lines then look for errors and double-check your work.
You can see the logs for a container with
docker logs container-id.
Get the container id with
Stop the containers and restart them in daemon mode, like this: