Skip to main content

Set Up Portainer at Home: Step by Step

Portainer gives you a web dashboard for everything running in Docker on your machine, so nothing is quietly running that you have forgotten about. This gets a basic instance running in a few minutes.

Reading is great. Tracking makes it stick. Sign up for a free Dashboard to tick off tasks and see your Security Score.

Get my free Dashboard →
CE: Secure Configuration⏱ 10 minutes
A laptop screen showing a terminal window

Cyber Nova AI helps you prepare for Cyber Essentials. It doesn't award or certify it. Follow the steps here to get ready, then apply for certification through an accredited Cyber Essentials body when you're set.

What you will need

  • Docker already installed on the machine you want to manage
  • About 10 minutes
  • A browser on any device on the same network
1

Create a volume for its data

This keeps Portainer’s own settings and users separate from the containers it manages:

docker volume create portainer_data
2

Run the container

Start Portainer with access to the Docker socket, so it can see and manage other containers:

docker run -d -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest

Note: Mounting the Docker socket gives Portainer full control over Docker on this machine, the same level of access root has. Treat its login as seriously as any admin account on your network.

3

Open the dashboard and create your admin account

Visit the web interface, it uses HTTPS by default with a self-signed certificate:

https://<your-server-ip>:9443

Note: Your browser will warn about the certificate the first time, that is expected for a self-signed one on your own network. Set a strong admin password when prompted, you only get one attempt within a short time limit before it needs a restart.

4

Connect it to your local Docker environment

Choose "Get Started" and select the local Docker environment it detects automatically. You will land on a dashboard showing every running and stopped container.

What you will have at the end

A working dashboard showing everything currently running in Docker on your machine, with the ability to stop, start, or update any of it without the command line.

What to actually do with it

A dashboard on its own does not improve security, using it consistently does.

3 steps

Frequently asked questions

Is it safe to give Portainer access to the Docker socket?

It needs that access to do its job, since it is effectively equivalent to root access on the machine. Keep its login strong and do not expose the dashboard to the internet.

Can Portainer manage containers on more than one machine?

Yes, through its agent feature you can connect and manage Docker on several machines from a single Portainer dashboard.

Do I need the paid version?

No, the free Community Edition covers everything a home lab needs: viewing, starting, stopping and updating containers from one dashboard.

Track your AI safety progress. Free.

Create a free account to tick off tasks, see your Security Score improve, and know exactly what you've done and what's still to do.

Start your free security check
← Back to AI Homelab Projects Hub