NEW: UmbrelOS in a Docker container

I created a Docker container of UmbrelOS, so it can be run on any system without the need for dedicated hardware or virtual machines.

Ofcourse this method will not be officially supported, but it might be useful for some people who don’t mind to experiment, and who are looking for an easy way to run UmbrelOS.

It’s available to try now: GitHub - dockur/umbrel: UmbrelOS inside a Docker container.

Let me know what you think!

7 Likes

That means I can theoretically run Umbrel as an app in Umbrel? And then I can run Umbrel as an app in the Umbrel app… :joy:

1 Like

Yes!!! Matryoshka dolls!

Fantastic, great job!

Do you think this will survive an Umbrel upgrade, as I guess they mess a bit with the partitions…?

You cannot perform an upgrade directly from the UI (it will give an error), so nothing can go wrong.

Instead you have to do it in the “Docker way”, that means by pulling a newer version of the image.

1 Like

Right, perfect, thanks a lot!

Pulling a new version of the image could remove any data? I am not sure if all the user data of umbrel lies on the mounted /data volume

No, it does not remove any user data.

Great work! I was using a Virtual Machine, but a simple docker container is much easier!

1 Like

@kroese great job! Would you be willing to help me create a docker containers for Sparrow Wallet and SimpleX so we can get them submitted as official apps?

I copied (preserving mode & ownership) the data directory from my umbrel that was runnning in the VM (/umbrel-os/home/umbrel/umbrel), launched the docker and worked without any problem! All previously installed apps are working:

  • Bitcoin Node
  • Electrs
  • mempool
  • Lightning Node
  • ThunderHub
  • Tailscale
    I was really afraid that I wouldn’t be able to retrieve the state of the lighting channels or that there would be some problem with tor… but everything seems to be working fine.

NOTE: the host machine for the VM and the docker container is the same.

4 Likes

Hi! This looks cool! Could you write here, a short tutorial for beginners on how to run it, for example, using ubuntu server in the latest version 24.04? Is this even possible? I recently tried to do this and despite installing docker and downloading the image and running it with no apparent errors, when I type the ip address of my server in the browser nothing happens. The firewall was off at the time, I also tried adding port:80 to the server’s IP address. It did nothing, the IP address does not respond and it should display the dashboard…

Anyone had any success running this on their VPS?

Did you run the image as shown in github (/home/example should point to a valid directory in your host)?

docker run -it --rm -p 80:80 -v /home/example:/data -v /var/run/docker.sock:/var/run/docker.sock --pid=host --stop-timeout 60 dockurr/umbrel

The -p 80:80 option configures the bridge between your host and your container. Can you show the ouptup of the command docker ps?

NOTE: Once everything is working, you can run the container in daemon mode (-d instead of -it):

docker run -d --rm -p 80:80 -v /home/example:/data -v /var/run/docker.sock:/var/run/docker.sock --pid=host --stop-timeout 60 dockurr/umbrel

1 Like

Thank you for your help. It turns out that my problem was that I had the firewall set wrong, I had to open port 80.

1 Like