> ## Content Index > Fetch the complete content index at: https://www.blackvoid.club/llms.txt > Use this file to discover other available public pages before exploring further. # Portainer - Docker container management made easy - URL: https://www.blackvoid.club/portainer-docker/ - Published: 2020-09-23T22:34:42.000Z - Updated: 2023-07-09T23:17:28.000Z - Author: Luka Manestar - Tags: docker, portainer 📢 **UPDATE**: **11/02/2023** \- added a new section to update the article with a **new 2.17 Business edition version of Portainer** In order to run the new business edition of Portainer that allows the management of 3 Docker hosts for free, we need to run the `portainer-ee` Docker image as well as get the license code. To get the code, head over to [https://www.portainer.io/take-3](https://www.portainer.io/take-3?ref=blackvoid.club) and fill out the form. Within a few minutes, the code will arrive on the registered email. ![](https://www.blackvoid.club/content/images/2023/02/Screenshot-2023-02-11-at-10.41.40.png) Fill out the form to register for Portainer Business Now that we have the code, we can either upgrade from the community edition (`portainer-ce`, explained how to set up in the next part of the article), or start with the business edition using the following method. As with any docker container running on the Synology NAS, we need to log into it using SSH and elevate it to `root` permissions in order to run the `docker run` command. ### STEP01 - log into your NAS as root Depending on your OS of choice (Linux, macOS, Win) you will have to use an SSH-capable app to log into your NAS. Also, be sure that you have enabled SSH on your Synology NAS before doing this (**Control Panel > Terminal > enable SSH**). On macOS open up the **Terminal** app and type: `ssh your_NAS_account@yourNASip` hit return and you should be prompted for a password. After you have logged inside you need to elevate to the *root* account by using the following command: `sudo -i` again, you will be prompted for a password. Enter your initial user password and you will see how the command line has changed to *root*. ### STEP02 - download (pull) the Portainer EE repo Now we need to download the repo from the Hub: `docker pull portainer/portainer-ee:latest` ### STEP03 - configure and run the repo Now we are ready to run a single command line to start Portainer on your NAS: `docker run -d --name=portainer_ee --restart always -v /volume/docker/portainer_ee/data:/data -v /var/run/docker.sock:/var/run/docker.sock -p 9000:9000 --pid=host portainer/portainer-ee:latest` 🗒️ **NOTE**: Be sure to create your local destination **before** you run the command line! In this example that would be **volume1/docker/portainer\_ee/data** Now that we have Portainer up and running, go to the URL `http://yourNASip:9000`, create an account and start running multiple hosts! ![](https://www.blackvoid.club/content/images/2023/02/Screenshot-2023-02-11-at-10.49.50.png) Portainer Business edition (EE) managing 5 Docker hosts Under the **Environments** section there will be options to add new Docker hosts in case there is a need to connect multiple ones to this single Portainer instance. --- 📢 **NOTE**: Info below is the original article **referencing the CE (community edition) version of Portainer**! The setup is still the same just the images are a bit dated. This short article will be about Docker management. I meant to write it up sooner but always pushed it back because everything can be done using the command line. If you are into Docker or just starting, you will know (or soon find out) that it is a command-line-based platform. There is nothing you can't do with Docker this way but sometimes you might want to have a nice UI that will help you navigate more easily, do more, and have an overview of your container's usage and multiple hosts. This is where [Portainer.io](https://www.portainer.io/?ref=blackvoid.club) comes in. I use Docker daily across all my NAS devices and using Synology as a brand has its problems when it comes to Docker. The most obvious one is that it's Docker UI that is not up to the task when it comes to working with more complex container setups. Maybe you have noticed that most of my Docker articles revolve around using the command line deploy method. The reason is that not everyone visiting here is using Synology as their Docker host, and on top of this, you can apply these Docker containers to any host you do use. However, saying this at some point I started to use Portainer for several reasons: - Multiple host control under one UI - Overview of unused repos and the option to delete them with ease - Faster deployment of a complex instance using stacks (docker-compose) - CPU/RAM utilization overview per container (apart from my Grafana dashboard) - Ability to run any container with any switch, or variable settings using a UI There are just a few reasons why I like Portainer. So with all that said let's see how to deploy a Portainer container on your Docker host to control that same host and any other potential host using an agent repo (image). ### Configure and start Portainer on your Docker host For this example, we will use an official Portainer 2.0 CE version of Portainer. 🗒️ **NOTE**: for this to run you will have to log into your NAS via SSH and elevate to root to run this container ### STEP01 - log into your NAS as root Depending on your OS of choice (Linux, macOS, Win) you will have to use an SSH-capable app to log into your NAS. Also, be sure that you have enabled SSH on your Synology NAS before doing this (**Control Panel > Terminal > enable SSH**). On macOS open up the **Terminal** app and type: `ssh your_NAS_account@yourNASip` hit return and you should be prompted for a password. After you have logged inside you need to elevate to the *root* account by using the following command: `sudo -i` again, you will be prompted for a password. Enter your initial user password and you will see how the command line has changed to *root*. ### STEP02 - download (pull) the Portainer 2.0 CE repo Now we need to download the repo from the Hub: `docker pull portainer/portainer-ce:latest` ### STEP03 - configure and run the repo Now we are ready to run a single command line to start Portainer on your NAS: `docker run -d --name=portainer_ce --restart always -v /volume/docker/portainer_ce/data:/data -v /var/run/docker.sock:/var/run/docker.sock -p 9000:9000 --pid=host portainer/portainer-ce:latest` Just a few pointers on this command. Portainer will maintain its "database" and configuration inside its */data* folder so we are mapping that folder to a destination of your choice. In this case, the destination is a folder on location */volume1/docker/portainer\_ce/data*. 🗒️ **NOTE**: Be sure to create your local destination **before** you run the command line! On top of this one of the most important parameters is docker.sock. docker. sock is the UNIX socket that the Docker daemon is listening to, so be sure to map it or Portainer will not be able to connect to your Docker host and maintain the whole environment. You are welcome to change the port as well, the default web UI port is 9000 but you can configure your own. If you do change it, make sure to just change the **left** value, local port number, and not the right-hand side (container side). So one example could be: `-p 9500:9000` Once you have done all the changes, run the command line and that's it. Easy right? ### STEP04 - configure your Portainer account and connect to your host One final thing to do is to log into your Portainer UI and connect to your Docker host. Open your browser and go to the following URL: `http://youNASip:9000` If you have used a different port be sure to use the correct port. This will open up a welcome wizard to create your admin account to log in. Once you have done that you need to configure Portainer to attach to your Docker host. You will be presented with the following screen after you have logged in: ![](https://www.blackvoid.club/content/images/2020/09/42587801-7f68866a-8544-11e8-8f0a-026e60a266ab.PNG) Select "Local" to connect Portiner to your Docker host Select **Local** and click **Connect**. You can note that Portianer is telling you that you should have docker.sock mapped in order to work. If everything is set you will get a similar image like this. ![](https://www.blackvoid.club/content/images/2020/09/Screenshot-2020-09-24-at-00.31.15.png) This will tell you that you have connected Portainer to your Docker host If you can see the green "up" icon you are good to go. Well done! Later on, you can connect multiple Docker hosts to a single Portainer up using a Portainer agent (another article), and the end result might look like this: ![](https://www.blackvoid.club/content/images/2020/09/Screenshot-2020-09-24-at-00.33.19.png) Running multiple Docker hosts under a single Portainer instance via Portainer agents ### Add a Docker host to your Portainer using an agent If you do have multiple Docker hosts you can connect them to your new Portainer instance using a Docker agent. ### STEP01 - download and configure the Portainer agent `docker pull portainer/agent:latest` After this run the following command to start up your agent `docker run -d --name=portainer_agent --restart always -v /var/run/docker.sock:/var/run/docker.sock -p 9001:9001 --pid=host portainer/agent` ### STEP02 - add Docker agent host to Portainer Now, log into your Portainer and use the menu on the left side, and select **Endpoints**. Click on the blue "**\+ Add endpoint**" button, and you will land again on the same page that you had when you initially configured Portainer in step 04. ![](https://www.blackvoid.club/content/images/2020/09/image.png) Adding a new Docker host Enter your **Docker hostname** and its **Endpoint URL** by entering its LAN IP address and port, as presented in the image as an example. Finally, click again **Add endpoint** and you are done! ### Recap There you have it. A nice clean web UI to use for all your Docker needs. I did not go too much into detail regarding its options because this will be a topic for some other article. Also, I might refer to this article from now on, from time to time. As always, if you have any questions, let me know in the comment section.