Installation

Docker

docker-compose (Preferred)

1. Install docker-compose
2. Save the docker-compose.yml file.
3. Make edits to the docker-compose.yml file:
   • Volume paths for InfluxDB/Varken/Grafana. I personally save all of my container configs under /opt/dockerconfigs so you could, for example, make the top folder and 3 sub-folders in one command with mkdir /opt/dockerconfigs && cd /opt/dockerconfigs && mkdir grafana varken influxdb then fix the volume paths to show the above. Fixing influx, for example, to - /opt/dockerconfigs/influxdb:/var/lib/influxdb
   • You will see a TZ and a PUID/PGID variable for Varken. These are to set your timezone and your user/group permissions for your Varken data folder respectively.
4. The Grafana container requires specific folder permissions (since 5.1). Change the user/group ownership of your grafana data directory to 472. Example: chown 472:472 /opt/dockerconfigs/grafana
5. Start your InfluxDB Container. docker-compose up -d influxdb
6. Temporarily start your varken container. docker-compose up -d varken This will generate some folders and a varken.ini file in your varken data directory.
7. Stop your varken container with docker-compose down varken and edit your varken.ini file nano /opt/dockerconfigs/varken/varken.ini and follow the Configuration page to set it up appropriately. HINT: You can set the URL of influxdb to influxdb and it will work if they are on the same docker network
8. With your varken.ini complete, start your varken container again docker-compose up -d varken and watch the logs to see if you have missed anything docker logs -f varken
9. Finally, start your grafana container docker-compose up -d grafana . Follow the logs and make sure it starts up properly docker-compose up -d grafana If it does you should be able to access grafana at host-IP:3000
10. Import the official grafana dashboard

Command-line

Example:

docker run -d \
  --name=varken \
  -v <path to data>:/config \
  -e TZ=America/Chicago \
  docker pull ghcr.io/navino16/varken:develop

Use docker-compose instructions for process.

Upgrading

Command-line

docker stop varken
docker rm varken
docker pull docker pull ghcr.io/navino16/varken:develop
# Run deploy command as ran during installation

docker-compose

docker-compose pull varken
docker-compose up -d