Synology: Common Docker Issues and Fixes

Synology Common Docker Issues and Fixes

On mariushosting I have always wanted to create Docker guides that are compatible with most Synology NAS devices. I have made great efforts in this direction over the years and, thanks to your emails and posts and messages on Discord, I have been able to compile a list of common problems that most users experience when installing some Docker containers. Not all Synology NAS devices are the same when it comes to getting Docker containers to work, even though they allow you to install Docker. Below is a list of common problems you can face when you’re running Docker containers on your Synology NAS, and some great solutions to solve these problems.


In all the Docker guides present on mariushosting you will find STEP 1 which says Please Support My work by Making a Donation. Almost 99,9% of the people that install something using my guides forget to support my work, or just ignore STEP 1. I’ve been very honest about this aspect of my work since the beginning: I don’t run any ADS, I don’t require subscriptions, paid or otherwise, I don’t collect IPs, emails, and I don’t have any referral links from Amazon or other merchants. I also don’t have any POP-UPs or COOKIES. The main reason for this is because I want to offer a clean, safe and pleasant user experience to anyone coming to mariushosting. And I truly think it’s important we have this kind of experience in today’s online climate where you never truly know if what you’re reading is genuine content anymore. But for this I require your support. I do self-host so I have devices running 24/7/365. I do all the technical support work, admin work, I test and create content, from informing you of what’s new to providing complex technical tutorials with images and exact instructions and code that I specifically make work for this type of devices, take care of security and all other kinds of updates, and work to improve user experience all the time. But I need to be supported to be able to continue doing this kind of work. I have repeatedly been told over the years how much I have contributed to the community. It’s something I love doing and have been honest about my passion since the beginning. But I also Need The Community to Support me Back to be able to continue doing this work.

💡Clean your Docker

Sometimes, when you’re installing a Docker container on your Synology NAS, you can run into issues with getting said Docker container to run. This usually occurs when you are using different tutorials from several sources, or when you attempt to install a Docker container several times. Or when you’re not using a tutorial from mariushosting. You can experience different kinds of issues and get error messages like: [Warning] Access denied for user ‘root’@’localhost’ (using password: YES). To fix issues like this, you need to follow all the STEPS in my How to Clean Docker tutorial. Many Docker images and containers that you install on your Synology NAS following various guides on the web leave traces in your system that should be deleted so that future installations may work flawlessly.

💡MariaDB issues

As you know, I’m always busy working on testing new Dockers for your Synology NAS. Aside from the high volume of work this process entails, and the headaches that come with it, getting the Docker containers to run flawlessly also means I get to discover important pieces of information. For instance, in the past few months I have found that some mariaDB Docker images are not fully compatible with all Synology NAS devices, like the mariaDB image from Linuxserver and the original one. So because this version does not work flawlessly for some Synology NAS devices, I have replaced all the mariaDB Docker images in my Docker guides that required it with the mariadb:jammy – This version is the version for Ubuntu servers and it appears to fix all connection issues reported by various users over the years; it’s also fully compatible with Docker containers that require mariaDB as a database.

💡Synology NAS Firewall Issues

Sometimes, when you try to install a Docker container on your Synology NAS, you may get error messages in your Docker container logs that say “permission issue“, “aborted connection“, “db unhealthy” or “unable to connect“. Most of these issues can easily be fixed by properly configuring your Synology NAS Firewall. Be especially careful when you configure RULE 1, RULE 5 and RULE 6 in my article that explains How to Correctly Set Up Firewall on DSM 7.

💡Wrong UID and GID

As it so happens, many users forget to add their PUID and PGID values to the Docker containers that require them. Always make sure the PUID and PGID number values that you add are your own. Use my easy tutorial to find your own UID (userID) and GID (groupID) in 5 Seconds.

💡Wrong Folder Permissions in File Station

I still don’t know how this is possible, but some users have a different owner than the one stated in their UID and GID values on their Docker Folder. Right click on the folder for the Docker container, then Properties. Go to the General tab and make sure the folder has the “original” owner. Be sure to check Apply to this folder, sub-folder and files, then click Save.

Synology Folder Permissions Docker

💡Outdated Synology NAS Kernel under Version 4

Some Docker containers will not run on an older Linux Kernel, usually a Linux kernel version older than version 4. So if you have a Synology NAS device with, say, Linux Kernel 3.x then you will get the following error message for some Docker Containers: AH00141: Could not initialize random number generator. To fix this, you need a new Synology NAS that supports Linux Kernel 4.x. You can use my tutorial on How to Check Linux Kernel Version on your Synology NAS to find out what is your Linux Kernel version. If your Kernel is a version 3.x, then you can’t install some Docker containers, even if your NAS supports Docker. This aspect should be improved by Synology because it is not right for NAS owners to have a NAS that technically supports Docker, but which doesn’t support all Docker because of the outdated Kernel.

💡Outdated CPU without AVX Support

Have you ever gotten this error message with some Dockers that require the mongo database? WARNING: MongoDB 5.0+, MongoDB 6.0 requires a CPU with AVX support, and your current system does not appear to have that! stderr – If you have also received this message, know that it means that your NAS CPU does not support AVX. Some Docker containers cannot be installed on some NAS models with outdated CPUs that do not have AVX support. Advanced Vector Extensions, AVX for short, are extensions to the x86 instruction set architecture for microprocessors from Intel and AMD Advanced Micro Devices. To help provide a fix for this, I have written a guide to help you to choose the BEST Synology NAS device for Docker.

💡Docker Containers Work on Localhost, but Not Via HTTPS

If some Docker containers run well on your localhost, but you experience issues when you create a Reverse Proxy to access them online, most of the time you forgot to activate Web Socket.

This post was updated on Saturday / March 18th, 2023 at 3:36 PM