Skip to main content
The PPL Dashboard is distributed as a Docker image that runs on your local machine. Follow the steps below to install and run it.

​
Install Docker Desktop

Before pulling the PPL Dashboard image, ensure Docker Desktop is installed on your machine.
1

Download Docker Desktop

  • Visit the Docker Desktop download page.
  • Select the version for your operating system (Windows, macOS, or Linux) and download the installer.
2

Install Docker Desktop

  • Run the downloaded installer and follow the on-screen instructions.
  • On Windows, ensure WSL 2 is enabled if prompted.
  • On macOS, drag the Docker icon into the Applications folder.
3

Launch Docker Desktop

  • Open Docker Desktop from your applications.
  • Wait for Docker to fully start — the Docker icon in the system tray should indicate it is running.

​
Pull the PPL Dashboard Image

Once Docker Desktop is running, pull the PPL Dashboard image from Docker Hub.
1

Open a Terminal

Open a terminal on your local machine:
  • Windows: use Command Prompt, PowerShell, or Git Bash.
  • macOS or Linux: open the default Terminal application.
2

Pull the Docker Image

Run the following command to pull the PPL Dashboard image from Docker Hub:
docker pull directenergypartners/ppl-dashboard

​
Run the PPL Dashboard

You can start the PPL Dashboard using either the terminal or Docker Desktop.