Prometheus Installation systemd

Running Prometheus directly from the binary has two practical limitations:

It runs in the foreground, so closing your terminal stops the process.
It won’t start automatically after a system reboot.

This guide shows how to install Prometheus, place its files in standard system locations, and create a systemd service so Prometheus runs in the background, can be managed with systemctl, and starts automatically at boot.

Overview

High-level steps:

Create a dedicated, non-login prometheus user.
Create directories for configuration and TSDB storage.
Download and extract Prometheus.
Install binaries and CLI tools to /usr/local/bin.
Copy consoles, libraries, and the config file into /etc/prometheus.
Test a manual run as the prometheus user.
Create a systemd unit file.
Reload systemd, start, and enable the service.

1) Create a Prometheus user

Create a dedicated system user that cannot log in interactively:

sudo useradd --no-create-home --shell /bin/false prometheus

Using a dedicated, non-login user reduces risk by limiting file access and attack surface for the Prometheus process.

2) Create directories for configuration and data

Create paths for Prometheus configuration and time-series data, then set ownership to the prometheus user and group:

sudo mkdir -p /etc/prometheus
sudo mkdir -p /var/lib/prometheus

sudo chown prometheus:prometheus /var/lib/prometheus
sudo chown prometheus:prometheus /etc/prometheus

These directories follow common Linux conventions: /etc for configuration and /var/lib for persistent service data.

3) Download and extract Prometheus

Download the Prometheus release tarball (example uses v2.37.0). Change the version string as required for newer releases:

wget https://github.com/prometheus/prometheus/releases/download/v2.37.0/prometheus-2.37.0.linux-amd64.tar.gz
tar xvf prometheus-2.37.0.linux-amd64.tar.gz

4) Install binaries and CLI tools

Copy the Prometheus binary and the promtool utility into /usr/local/bin and set ownership and permissions:

sudo cp prometheus-2.37.0.linux-amd64/prometheus /usr/local/bin/
sudo cp prometheus-2.37.0.linux-amd64/promtool /usr/local/bin/

sudo chown prometheus:prometheus /usr/local/bin/prometheus /usr/local/bin/promtool
sudo chmod 0755 /usr/local/bin/prometheus /usr/local/bin/promtool

Installing under /usr/local/bin keeps system-managed binaries separate from distribution packages.

5) Install console templates, libraries, and the config file

Copy the consoles and console_libraries directories plus your prometheus.yml into /etc/prometheus, then ensure the prometheus user owns them:

sudo cp -r prometheus-2.37.0.linux-amd64/consoles /etc/prometheus
sudo cp -r prometheus-2.37.0.linux-amd64/console_libraries /etc/prometheus

sudo cp prometheus-2.37.0.linux-amd64/prometheus.yml /etc/prometheus/prometheus.yml

sudo chown -R prometheus:prometheus /etc/prometheus

Note: consoles and console_libraries are used by the web-based Prometheus console (optional for basic scraping/storage).

6) Manual test run as the prometheus user

Before creating the systemd unit, verify Prometheus runs correctly as the prometheus user. This is the same command the systemd unit will use:

sudo -u prometheus /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

If the web UI is accessible on the default port (9090) and there are no errors, stop the process (Ctrl+C) and proceed to create the systemd unit.

7) Create a systemd unit file

Create the unit file at /etc/systemd/system/prometheus.service:

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

Paste the following content into the file:

[Unit]
Description=Prometheus Time Series Collection and Processing Server
Wants=network-online.target
After=network-online.target

[Service]
User=prometheus
Group=prometheus
Type=simple
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

[Install]
WantedBy=multi-user.target

What the unit sections mean:

Section	Purpose	Example / Notes
`[Unit]`	Describes service ordering and dependencies	`After=network-online.target` waits for network availability
`[Service]`	Defines runtime parameters, user identity, and the start command	`User=prometheus` and `ExecStart` specify the process to run
`[Install]`	Controls how the service is installed/enabled for boot targets	`WantedBy=multi-user.target` adds it to the normal boot sequence

The unit ensures Prometheus starts after the network is up and runs with the least privileges.

8) Reload systemd, start, and enable Prometheus

After creating or changing a unit file, reload systemd and then start and enable the service:

sudo systemctl daemon-reload
sudo systemctl start prometheus
sudo systemctl status prometheus

Enable Prometheus at boot:

sudo systemctl enable prometheus
sudo systemctl status prometheus

systemctl status should report the unit as active (running) and enabled.

If you update /etc/prometheus/prometheus.yml, reload the service to apply changes: sudo systemctl restart prometheus. For configuration checks, use promtool check config /etc/prometheus/prometheus.yml.

Troubleshooting tips

Verify permissions: ensure /etc/prometheus and /var/lib/prometheus are owned by prometheus:prometheus.
Check logs: sudo journalctl -u prometheus -f shows real-time unit logs.
Port conflicts: if 9090 is already used, change --web.listen-address in the unit or config to a different port.

Links and references

Prometheus official releases and binaries: https://github.com/prometheus/prometheus/releases
Prometheus documentation: https://prometheus.io/docs/
systemd service unit documentation: https://www.freedesktop.org/wiki/Software/systemd/Documentation/

You now have Prometheus installed and running under systemd, manageable with systemctl and configured to start automatically at boot.

Introduction

Observability Fundamentals

Prometheus Fundamentals

PromQL

Dashboarding & Visualization

Application Instrumentation

Service Discovery

Push Gateway

Alerting

Monitoring Kubernetes

Conclusion

Scaling & Long Term Storage

Prometheus Installation systemd

Overview

1) Create a Prometheus user

2) Create directories for configuration and data

3) Download and extract Prometheus

4) Install binaries and CLI tools

5) Install console templates, libraries, and the config file

6) Manual test run as the prometheus user

7) Create a systemd unit file

8) Reload systemd, start, and enable Prometheus

Troubleshooting tips

Links and references

Watch Video

​Overview

​1) Create a Prometheus user

​2) Create directories for configuration and data

​3) Download and extract Prometheus

​4) Install binaries and CLI tools

​5) Install console templates, libraries, and the config file

​6) Manual test run as the prometheus user

​7) Create a systemd unit file

​8) Reload systemd, start, and enable Prometheus

​Troubleshooting tips

​Links and references

Watch Video

Overview

1) Create a Prometheus user

2) Create directories for configuration and data

3) Download and extract Prometheus

4) Install binaries and CLI tools

5) Install console templates, libraries, and the config file

6) Manual test run as the prometheus user

7) Create a systemd unit file

8) Reload systemd, start, and enable Prometheus

Troubleshooting tips

Links and references