HowTo: Raspberry Pi - Using Docker Container with OpenMediaVault OMV and Portainer

Another practical advantage of OpenMediaVault is that you can easily add further functions thanks to the prepared Docker and Portainer installation.

Docker containers are a type of software package that considerably simplify the distribution and installation of programs. Instead of having to install the desired program, you simply have to activate the Docker container on your system. This automatically copies, configures and installs all the necessary settings, dependencies and more. In most cases, you then only have to adapt the configuration to your needs. These features have led to more and more developers offering their programs as Docker containers.

Portainer is an extension for Docker. With Docker alone, you can also install Docker containers. However, you have to configure everything "manually" via your system's console. Thanks to Portainer, however, you can also do this conveniently via a web interface. You can add, delete and manage new Docker containers on the Portainer web interface. This simplifies the entire process considerably.

To use a Docker container on your system, you only need to initiate the installation of Docker and Portainer. The option to do this is easily accessible via the OpenMediaVault web interface. As soon as the installation is started, it runs automatically and Docker or Portainer is available on your system after a few minutes.

Of course, you will then need to make a few brief settings. The following article describes how to do this and how to get started with a Docker container on your system.

Safety instructions

I know the following notes are always kind of annoying and seem unnecessary. Unfortunately, many people who knew "better" have lost eyes, fingers or other things due to carelessness or injured themselves. Data loss is almost negligible in comparison, but even these can be really annoying. Therefore, please take five minutes to read the safety instructions. Because even the coolest project is not worth injury or other trouble.

Affiliate links/advertising links

The links to online shops listed here are so-called affiliate links. If you click on such an affiliate link and make a purchase via this link, will receive a commission from the relevant online shop or provider. The price does not change for you. If you make your purchases via these links, you support in being able to offer other useful projects in the future. 🙂 


Helpful articles:
Before you start with this article you should have prepared the RaspberryPi so that it is accessible via the network and controllable via SSH.

The following three articles describe what needs to be done to prepare the RaspberryPi:

In the following lists you will find all the parts you need to implement this article.

Required tool:

1xScrewdriver set  Buy at Amazon
1xSD card reader  Buy at Amazon

Required material:

1x Raspberry Pi  Buy at Amazon
1x Raspberry Pi power supply  Buy at Amazon
1x Raspberry Pi case  Buy at Amazon
1x Micro SD card 64GB  Buy at Amazon

Install Docker

To be able to use Docker and Portainer, you must first install both.

To do this, first log into the OpenMediaVault web interface.

You can find information on this in the article

Then click on the menu item

  • System / omv-extras

Then first click on the

  • "Docker" button...

... and in the next window click on

  • Install

The installation will then start and should...

... be completed after a short time.

Install Portainer

Now you can also install Portainer. The installation procedure is basically the same.

Switches back to the menu item

  • System / omv-extras

And click on the next view on

  • Install

If desired, you can of course also adjust the ports under which the Portainer web interface is accessible. Normally, however, this is not necessary.

The installation will then run automatically and should be completed shortly afterwards.

Opening and configuring the Portainer interface

After installing Portainer, you should now open the web interface to make a few simple settings.

You can also access the Portainer interface by clicking on

  • openweb

in the Portainer menu in OpenMediaVault.

The Portainer interface will then open and...

... you will first be asked to set a password for the administrator account.

Enter your desired password here and confirm it by clicking on

  • Create user

Now you can click on the

  • Get started

button to configure your first Docker container.

Installing a Docker container

After you have installed Docker and Portainer, you can start a first test. In this example, the Docker container is installed with the Docker stock feature.

To do this, click on the Environment button on the home interface of the Portainer web interface.

  • local

Then click on

  • stacks

and in the next step to

  • +Addstack

You can now configure the Docker stack in the following window.

To do this, you must first enter a name for the Docker stack.

In this example, I am using a Docker container from the "Frigate" project. This is a system for the automated evaluation of video streams from a surveillance camera.

At this point, you should also adjust the configuration in the lower text field to your requirements. The settings at this point ultimately determine how the Docker container is configured.

You can usually find more information on the available options in the documentation of the respective project.

As soon as you have finished configuring everything, you can start the Docker container. Simply click on the button

  • Deploy the stack

More articles about Open Media Vault

This completes the installation of OMV. The many other functions I have described in other articles. There you will also find hints on how to extend the functionality of your OMV installation. These articles are all summarized in the following categories.

Have fun with the project

I hope everything worked as described for you. If not or you have questions or suggestions please let me know in the comments. I will then add this to the article if necessary.
Ideas for new projects are always welcome. 🙂

PS Many of these projects - especially the hardware projects - cost a lot of time and money. Of course I do this because I enjoy it, but if you think it's cool that I share the information with you, I would be happy about a small donation to the coffee fund. 🙂

Buy Me a Coffee at       

Kommentar hinterlassen

Your email address will not be published. Erforderliche Felder sind mit * markiert

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