How to run Prometheus with Podman

Prometheus is an open-source system monitoring and alerting toolkit. Prometheus collects and stores its metrics as time-series data. Metrics information is stored with the timestamp at which it was recorded, alongside optional key-value pairs called labels.

In this tutorial we are going to learn how to run Prometheus with Podman.

Components of Prometheus

  • Has an alertmanager to handle alerts
  • Has a push gateway for supporting short-lived jobs
  • Has main Prometheus server which scrapes and stores time series data
  • Client libraries for instrumenting application code
  • Special purpose exporters for services like HAProxy, statD, Graphite etc

Related Articles


  • Have a basic understanding of Linux terminal
  • Make sure you have access to internet

Table of Contents

  • Run system updates
  • Install podman
  • Pull Prometheus image
  • Start Prometheus

Run system updates

Running system updates are mandatory if you expect your system packages to be up to date every time. Let’s run updates with the following command; I am using Fedora 35, you can use any distro you like.

$ sudo dnf update -y

When the updates are complete, we can proceed to install podman.

2. Install Podman

Podman is a daemon-less, open-source, Linux native tool designed to make it easy to find, run, build, share and deploy applications using Open Container Initiative (OCI) containers and container images. Containers can be run as root or as a regular users. Podman = Docker

Let’s install Podman with the following command;

$ sudo dnf install podman -y

You have successfully installed podman on Fedora 35.

You will see the following sample output.

Sample output
 podman                                 x86_64            3:3.4.2-1.fc35                updates             12 M
  catatonit-0.1.7-1.fc35.x86_64                        conmon-2:2.0.30-2.fc35.x86_64                             
  container-selinux-2:2.170.0-2.fc35.noarch            containernetworking-plugins-1.0.1-1.fc35.x86_64           
  containers-common-4:1-32.fc35.noarch                 criu-3.16.1-2.fc35.x86_64                                 
  criu-libs-3.16.1-2.fc35.x86_64                       crun-1.3-1.fc35.x86_64                                    
  dnsmasq-2.86-3.fc35.x86_64                           fuse-common-3.10.5-1.fc35.x86_64                          
  fuse-overlayfs-1.7.1-2.fc35.x86_64                   fuse3-3.10.5-1.fc35.x86_64                                
  fuse3-libs-3.10.5-1.fc35.x86_64                      iptables-legacy-1.8.7-13.fc35.x86_64                      
  libbsd-0.10.0-8.fc35.x86_64                          libnet-1.2-4.fc35.x86_64                                  
  libnftnl-1.2.0-2.fc35.x86_64                         libslirp-4.6.1-2.fc35.x86_64                              
  nftables-1:1.0.0-1.fc35.x86_64                       podman-3:3.4.2-1.fc35.x86_64                              
  podman-gvproxy-3:3.4.2-1.fc35.x86_64                 podman-plugins-3:3.4.2-1.fc35.x86_64                      
  shadow-utils-subid-2:4.9-7.fc35.x86_64               slirp4netns-1.1.12-2.fc35.x86_64                          


You can check the version of Podman installed.

$ podman --version
podman version 3.4.2

If you get the version of Podman, then you have successfully installed Podman.

Now we can proceed to pull Prometheus image.

3. Pull Prometheus image.

To pull Prometheus, use the podman pull command. Let’s see how we can do that;

$ podman pull prom/prometheus

You will get the following sample output. Choose where you could pull your image from.

Sample output
? Please select an image:
Trying to pull
Getting image source signatures
Copying blob 620e8dfd5447 done  
Copying blob 21b2df964046 done  
Copying blob ddd09594f788 done  
Copying blob aa2a8d90b84c done  
Copying blob b45d31ee2d7f done  
Copying blob 7d3b94bc0edd done  
Copying blob ddbba1a8341e done  
Copying blob ceb78b2ad8d8 done  
Copying blob cf4a6b37f5be done  
Copying blob ae4192f5013d done  
Copying blob f87c90634d35 done  
Copying blob 1860fdfbca21 done  
Copying config c10e9cbf22 done  
Writing manifest to image destination
Storing signatures

From the above choices, you can only pull from

We can verify our image like this;

$ podman images 
REPOSITORY                 TAG         IMAGE ID      CREATED      SIZE  latest      c10e9cbf22cd  2 weeks ago  196 MB

We can see that our imge is there. To confirm use the image ID.

4. Start Prometheus Container

To start Prometheus, we would first need to create a directory where we will store our data.

$ sudo mkdir data
cd data

Once inside data directory run the following command power up the Prometheus.

$ podman run --name myprometheus -d -p 9090:9090 -v $(pwd):/data/db:Z prometheus 

You can use podman ps command to know if it running;

$ podman ps
CONTAINER ID  IMAGE                             COMMAND               CREATED         STATUS             PORTS                   NAMES
64779f0e23f6  --config.file=/et...  22 seconds ago  Up 22 seconds ago>9090/tcp  myprometheus

From the above, it shows it is up

Now let’s open prometheus in our preferred browser.


You will get the following from the browser

Prometheus Dashboard
Prometheus Dashboard

Move to status and click configuration to see the Prometheus.yml file.

The following is a sample output.

Sample output
  scrape_interval: 15s
  scrape_timeout: 10s
  evaluation_interval: 15s
  - follow_redirects: true
    scheme: http
    timeout: 10s
    api_version: v2
    - targets: []
- job_name: prometheus
  honor_timestamps: true
  scrape_interval: 15s
  scrape_timeout: 10s
  metrics_path: /metrics
  scheme: http
  follow_redirects: true
  - targets:
    - localhost:9090

5. Conclusion

You have learned how to run Prometheus with Podman. Don’t hesitate to contact us in case of any difficulty. Also, you can read more on Podman Documentation.

About Kipkoech Sang

I am a technology enthusiast who loves to share gained knowledge through offering daily tips as a way of empowering others. I am fan of Linux and all other things open source.
View all posts by Kipkoech Sang →

Leave a Reply

Your email address will not be published. Required fields are marked *