Lighthouse can monitor and manage your PX clusters and storage. This guide shows you how you can run Lighthouse locally.

You must have an enterprise license to be able to download and install the portworx/px-lighthouse image. Please contact for access to this image and the install instructions.

Connect Lighthouse to your Portworx Cluster

Lighthouse runs as a Docker container and has the same minumum requirements as the Portworx storage solution. Please consult this guide for the minumum requirements.

Lighthouse connects to an existing PX cluster by talking to the same KVDB that your PX cluster uses. In order to get Lighthouse to manage your PX cluster, you must provide the following connection strings:

  • Key Value Database (KVDB) store: This must be the same KVDB store that your Portworx nodes use.
  • Influxdb: Light house stores the performance data of your PX cluster in this time series DB.

Setup Influxdb by following instructions on InfluxDB.

Connect to Lighthouse

Once you have Lighthouse installed, visit http://{IP_ADDRESS}:80 in your browser to access your locally running PX-Lighthouse. Here as a part of sign-up, you can create a root user and setup email server, that will be used to send emails for password reset, new user signup, Portworx alerts.


Create Portworx Cluster

Follow the instructions on Manage PX-Enterprise via Lighthouse.

Add users to Lighthouse

You have already setup a root user while signing up. Here, we are going to create additional users. Click on the gear icon on top right. From the dropdown, choose ‘Manage Users’. Here click on ‘New’, and fill out user name and email address.


By default lighthouse will create a cluster for this user names <user-name>-cluster and also add this user to a group called <user-name>-group. This user will only have admin access on the cluster that got created for him. These permission can be modified under Manage Users -> Groups -> Edit. Permissions are per comapnay and per cluster based.


PX-Lighthouse repository is located here. Above mentioned docker commands will upgrade your PX-Lighthouse container to the latest release. There should be minimal downtime in this upgrade process.

Provider Specific Instructions


  • Make sure you have set inbound security rule to ‘Allow’ for port 80.