Install Prometheus

Install Prometheus to collect and serve data


Prometheus handles data collection, storage, and queries. Data sources are configured as targets from which Prometheus will request metrics data. Prometheus stores this data and responds to Grafana queries against the data.

Create System Account

Create a system account under which Prometheus can run.

sudo adduser --system prometheus --group --no-create-home

Install Prometheus

The instructions below are for version 2.42.0. Check for newer versions of Prometheus, and adapt the instructions below.

Download the latest release.


Unpack the release.

tar xzvf prometheus-2.42.0.linux-amd64.tar.gz

Copy multiple executable files to /usr/local/bin.

cd prometheus-2.42.0.linux-amd64
sudo cp -t /usr/local/bin/ prometheus promtool

Create additional required directories.

sudo mkdir -p /etc/prometheus/console_libraries \
    /etc/prometheus/consoles \
    /etc/prometheus/files_sd \
    /etc/prometheus/rules \
    /etc/prometheus/rules.d \

Change ownership on the /var/lib/prometheus directory so the prometheus service can access it.

sudo chown prometheus:prometheus /var/lib/prometheus

Configure Startup

Create a systemd service file to configure automatic startup of the Prometheus service.

sudo nano /etc/systemd/system/prometheus.service

Insert the following into the Prometheus systemd service file.


ExecStart=/usr/local/bin/prometheus \
    --config.file /etc/prometheus/prometheus.yml \
    --storage.tsdb.path /var/lib/prometheus/ \
    --web.console.templates=/etc/prometheus/consoles \
    --web.console.libraries=/etc/prometheus/console_libraries \
ExecReload=kill -HUP $MAINPID

Data retention is set to 32 days in the default configuration. The number of days can be increased by changing the value assigned to the storage.tsdb.retention.time flag in the last line of the ExecStart configuration above.

Save the file and exit the editor.

Optional: Clean Up Installation Files

Remove the Prometheus archive and installation directory.

rm prometheus-2.42.0.linux-amd64.tar.gz
rm -rf prometheus-2.42.0.linux-amd64


Prometheus will listen on port 9090. This is the port for the Prometheus admin UI.

We have not yet configured nor started Prometheus.

Last updated