How to Run Docker on Proxmox with LXC

Introduction

This tutorial will guide you through the process of running Docker on Proxmox using LXC containers. Docker is not natively supported in Proxmox PVE, but with LXC, you can create a functional Docker environment. We will also cover the installation of Grafana as a sample application to demonstrate the setup.

Step 1: Download the Container Image

• Begin by downloading the container image you will use for your LXC.
• Ensure you have the latest updates by running the following command:

  apt-get update
  

Step 2: Create the LXC Container

• Access your Proxmox web interface.
• Click on "Create CT" to start the creation of a new LXC container.
• Fill in the necessary details such as:
  • Container ID
  • Hostname
  • Password
  • Template (choose your desired Linux distribution)

Step 3: Understand the Benefits of Using LXC for Docker

• LXC (Linux Containers) provides a lightweight, efficient environment for running applications like Docker.
• This method allows you to utilize Proxmox's virtualization capabilities without direct Docker support.

Step 4: Log in to the LXC Container

• Once the container is created, log into it using the following command:

  pct enter <container_id>
  

• Replace <container_id> with the ID of your LXC container.

Step 5: Install Docker on the LXC Container

• Update the package repository inside the LXC:

  apt-get update
  

• Install Docker using the following command:

  apt-get install docker.io
  

Step 6: Confirm Docker is Running

• Check if Docker is properly installed and running with:

  systemctl status docker
  

• Find the host IP address to ensure connectivity:

  hostname -I
  

Step 7: Run a Docker Container

• To run a sample Docker container, you can use the following command:

  docker run -d -p 3000:3000 grafana/grafana
  

• This command will run Grafana, which is a popular open-source analytics and monitoring solution.

Step 8: Confirm Docker Container is Running

• To verify that your Docker container is running, use:

  docker ps
  

• Ensure that Grafana is listed and check its network settings.

Conclusion

You have successfully set up Docker on Proxmox using LXC and installed Grafana as a test application. This process allows you to leverage containerization within your Proxmox environment efficiently. As a next step, consider exploring additional Docker containers or applications that can enhance your home lab setup. For more detailed guides and tutorials, visit House of Logic.