Skip to content
Get started

Portainer on a VPS

Web UI for Docker

Install on a VPSGitHub
Category
Dev / Tools
Hosting
Application hosting
Author
Portainer.io
License
Zlib
Version
2.45.1

The script is free · VPS from $2.79 per month · installs in about 60 seconds

Install over SSH

root@vps:~# command -v docker >/dev/null || curl -fsSL https://get.docker.com | sh; docker volume create portainer_data && docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:lts

  • SystemUbuntu 24.04 · x86_64ok
  • Sourcegithub.com/portainer/portainerok
  • Version2.45.1ok
  • Port9443/tcplisten
  • Port8000/tcplisten

✓ Portainer 2.45.1 installed · about 60 seconds

root@vps:~#

Install command from the library. Output is shortened and may differ on your server.

What it is

  • Docker
  • Web UI
  • Containers
  • Compose

Portainer is a web UI for Docker. In the browser you see all containers, images, volumes and networks, can view logs, open a container console and run Docker Compose stacks.

Handy when the server runs several services and working with docker in the terminal is inconvenient: restarting, updating an image and viewing logs take a couple of clicks.

Installed with the official Community Edition command using the lts tag.

  • Manage containers, images, volumes and networks
  • Docker Compose stacks from a web editor or Git
  • Container logs, stats and console in the browser
  • App templates for quick launch
  • Users and roles

Recommended plan

For Portainer: at least 1 vCPU, 2 GB RAM and 10 GB NVMe.

Minimum to run
1 vCPU · 1 GB RAM · 10 GB disk
Systems
Ubuntu 22.04 · Ubuntu 24.04 · Debian 12

How to install

Three steps in the bot or one command over SSH; installation takes about 60 seconds.

  1. 01

    Choose a plan in the bot

    Open @ExpressHost_bot and pay for a VPS. The server will be ready in about 60 seconds.

  2. 02

    Add Portainer

    At the “Add-ons” step pick the script from the library, or run it later: Server settings → Scripts.

  3. 03

    Finish the setup

    Immediately open https://server-IP:9443 and create the admin: otherwise Portainer closes the setup wizard after a few minutes

Manually over SSH

Connect to the server as root and run the command. Supported systems: Ubuntu 22.04, Ubuntu 24.04, Debian 12.

Install command
command -v docker >/dev/null || curl -fsSL https://get.docker.com | sh; docker volume create portainer_data && docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:lts

Ports

Portainer ports
PortProtocolPurpose
9443tcpWeb UI (HTTPS, self-signed certificate)
8000tcpTunnel for Edge agents (not always needed)

After installation

  1. 1.Immediately open https://server-IP:9443 and create the admin: otherwise Portainer closes the setup wizard after a few minutes
  2. 2.If you missed it, restart the container: docker restart portainer
  3. 3.Choose the local environment to manage Docker on this server

Portainer FAQ

Didn’t find an answer? Message @ExpressHost_SupportBot.

How do I update Portainer?

docker stop portainer && docker rm portainer && docker pull portainer/portainer-ce:lts, then start it with the same command. Settings stay in the portainer_data volume.

Is port 8000 required?

No, it's only needed for Edge agents. If you don't use them, remove -p 8000:8000.

Where is the data stored?

In the portainer_data Docker volume.

Portainer installs at checkout — in the bot.

Install PortainerBuy in Telegram