How to Install Portainer using Docker on Ubuntu

Step 1: Install Docker on Ubuntu

Before using Portainer, ensure you have Docker installed. If not, follow these steps:

1. Update your package manager's cache:

sudo apt update

2. Install required dependencies:

sudo apt install -y apt-transport-https ca-certificates curl software-properties-common

3. Add Docker's official GPG key:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

4. Add the Docker repository:

echo "deb [signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

5. Update the package index:

sudo apt update

6. Install Docker:

sudo apt install -y docker-ce docker-ce-cli containerd.io

7. Start and enable the Docker service:

sudo systemctl start docker
sudo systemctl enable docker

8. Verify Docker installation:

sudo docker --version

Step 2: Install Portainer

Deploy Portainer as a Docker container:

1. Pull the Portainer Docker image:

sudo docker pull portainer/portainer-ce

2. Create a Docker volume for Portainer data persistence:

sudo docker volume create portainer_data

3. Start the Portainer container:

sudo docker run -d -p 9000:9000 --name portainer --restart always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce

Step 3: Access Portainer

Access Portainer's web interface:

1. Open your web browser and navigate to:

http://your_server_ip:9000

Replace your_server_ip with the IP address of your Ubuntu server.

Step 4: Set Up Portainer

Complete Portainer's setup:

1. Choose a password for the admin user.
2. Specify a Portainer agent endpoint (leave as default for local Docker).
3. Click "Connect."
4. Create an admin user account (username and password).
5. Click "Create user."
6. You'll be redirected to the Portainer dashboard to manage Docker resources.

That's it! You've successfully installed Portainer in a Docker container on Ubuntu and can now use it to manage your Docker resources through its web-based interface.