Skip to content

Dockge Web UI for DSM 7.1 or Earlier

If you are on an end of life DSM version and can’t upgrade past the old “Docker” Synology package I recommend moving to using Dockge to manage your Docker Containers – This uses docker compose and means you can follow my newer guides and can learn to use compose.

There is nothing stopping you also using this instead of Container Manager!

Dockge is a nice simple WebUI its not as comprehensive as something like Portainer but that comes with its own set of plus and minus points.

The compose in this guide is using a fork of the original version which has some nice additional features, I am monitoring development and when needed I will update the guide between the original and the fork.

Let’s Begin

As the Synology DSM Docker GUI does not support some of the functions we need for this tutorial we will be using Docker Compose to initially set up Dockge. This is not as complicated as it might seem!

Initial set up

I have dropped links to the DSM7.1 / 7 initial set up guides below, follow these in order to get your media directories, Docker user and the “synobridge” set up. The versions on my new guides are for DSM7.2 and up so can be skipped.

Folder Setup

Initially create a folder for Dockge to store its config files and our docker compose files.

Folders
/docker/dockge/dockge-stacks

Docker Compose

To save you having to create a new compose file I have put the below compose in a premade .yml file. Download it and save it directly in /docker

As you can see below this will run Dockge on port 6001 as 5001 is used by DSM, it has access to the docker.sock in order to manage containers and has be configured to use the folder above to store its files.

YAML
services:
  dockge:
    image: cmcooper1980/dockge
    container_name: dockge
    ports:
      - 6001:5001
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /volume1/docker/dockge:/app/data #where dockge stores its config
      - /volume1/docker/dockge/dockge-stacks:/volume1/docker/dockge/dockge-stacks #where dockge stores your compose files
    environment:
      - DOCKGE_STACKS_DIR=/volume1/docker/dockge/dockge-stacks
    restart: unless-stopped

SSH and Docker-Compose

It’s time to get logged into you Diskstation via SSH, you can do this in the same way as when you obtained your IDs in the ‘Setting up a restricted Docker user‘ guide.

Once you have logged in you will need to give 2 commands, you can copy and paste these one at a time — you will need to enter your password for the command starting with ‘sudo’

First we are going to change directory to where the qbittorrentvpn.yml is located, type the below and then press enter.

Bash
cd /volume1/docker

Then we are going to instruct Docker Compose to read the file we created and complete the set-up of the container. Again type the below and press enter.

Bash
sudo docker-compose -f dockge.yml up -d

You will see Docker pull the Dockge image and then run it with no errors.

Dockge UI

You should now have access to the Dockge UI by going to your NAS IP and Port 6001 (e.g 192.168.0.10:6001

You will initially need to set up a username and password to secure the interface.

Once you have logged it you will be greeted with a nice blank UI to start building out your containers. If you have any running already they will be shown in the list however you will not be able to manage then, this is a good time to start learning how to use Docker Compose and migrate your existing containers over!

Do I need to do anything different when using your Container Manager guides?

Yes you will need to make some small adjustments there are actually fewer steps!

When the start of the guide calls for you to set up a User / Shared Folders / Bridge you have already done this at the start of this guide so you can skip that element

In the Folder creation steps you don’t need to create a “projects” folder as Dockge takes care of keeping you compose files safe.

When using the compose you need to this in Dockge, the UI is a bit different however fairly self explanatory – You click Compose on the top left – Provide the “project” aka compose name and then paste the contents of the compose from the guide, making any adjustments required.

Also you can directly update your containers by pressing the “Update” button no need to use the old Docker package!

You can now use the up to date guides on the left menu!

Published inGeneral News

Be First to Comment

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

drfrankenstein.co.uk – writing Synology Docker Guides since 2016 – Join My Discord!