Portainer provides a graphical web dashboard for managing Docker containers, images, networks, and volumes — useful if you'd rather click through a UI than remember every CLI command. This guide installs Portainer Community Edition as a Docker container itself.
Prerequisites
- Docker Engine installed and running
- Root or sudo access
Step 1 — Create a Persistent Volume
docker volume create portainer_data
Step 2 — Run Portainer
docker run -d \
--name portainer \
--restart unless-stopped \
-p 8000:8000 \
-p 9443:9443 \
-v /var/run/docker.sock:/var/run/docker.sock \
-v portainer_data:/data \
portainer/portainer-ce:latest
Step 3 — Allow the Port Through the Firewall
sudo ufw allow 9443/tcp
Step 4 — Access the Dashboard
Open in your browser:
https://YOUR_SERVER_IP:9443
Your browser will show a self-signed certificate warning — this is expected on first setup.
Step 5 — Create the Administrator Account
On first login, set a strong administrator username and password.
Step 6 — Connect to the Local Docker Environment
Select Local and click Connect. Portainer will display all existing containers, images, and volumes on the host.
What You Can Manage from Portainer
- Start, stop, and restart containers
- Deploy new stacks from a Docker Compose file, pasted directly into the UI
- View real-time logs and resource usage per container
- Manage volumes, networks, and images
- Set up additional users with role-based access
Deploying a Stack via Portainer
Go to Stacks → Add Stack, paste your docker-compose.yml content, and click Deploy — equivalent to running docker compose up -d from the command line.
Common Errors
Can't reach port 9443 — confirm the firewall rule was added and the container is running: docker ps.
"Access denied" connecting to the local environment — verify the Docker socket was correctly mounted with -v /var/run/docker.sock:/var/run/docker.sock.
Security Best Practices
- Restrict port 9443 to trusted IPs at the firewall level if possible
- Use a strong, unique administrator password
- Mounting the Docker socket gives Portainer root-equivalent control over the host — only run it on servers you trust and secure appropriately
FAQ
Is Portainer free?
Portainer Community Edition is free and covers all core container management features used in this guide.
Related Articles
- Deploy Your First Docker Container
- How to Install Nginx Proxy Manager with Docker
- Docker Security Best Practices
