Skip to main content

Deploy with Docker


  1. Install SigNoz backend as instructed in this page
  2. Instrument your application as instructed in Instructions Page

You can install SigNoz backend in following 2 ways:

  1. Using Install Script
  2. Using Docker Compose

We have explained each of these ways in the following sections:

1. Using Install Script

If you are on Mac or any of the following linux distributions, using our install script should be the easiest way to get started:

  • Ubuntu
  • Debian
  • OpenSuse
  • CentOS
  • SUSE Linux Enterprise Server (SLES)

Docker Desktop must be installed manually on Mac OS to proceed. Docker can only be installed automatically using install script on above linux distros.

If you are neither on any of the above distributions nor on Mac, please install directly using Docker Compose.

Here's a quick guide to install Docker Compose if you don't have it set up already.


[Update December 2, 2021]
Currently, we have not tested these instructions to run SigNoz on Windows. But you can try it.

  1. To clone the SigNoz repository and enter the new directory, run:
git clone && cd signoz/deploy/

  1. To run SigNoz:

Check that you are in signoz/deploy folder. Now run


  1. Once runs successfully, the UI should be accessible at port 3000 on the domain you set up or the IP of your instance.


Wait for 2-3 mins for the data to be available to frontend. If you are running on local machine, checkout http://localhost:3000. You would want to open port 3000 to be accessible from outside world if you want to use public url of machine.

2. Using Docker Compose

  1. To clone the SigNoz repository and enter the new directory, run:
git clone && cd signoz/deploy/

  1. We will now set up SigNoz via docker compose. This will set up the required dependencies and also load a sample app.

You need to have docker-compose correctly setup before running this.

If you don't have docker-compose set up, please follow this guide to set up docker compose before proceeding with the next steps.

For v0.5.0 and earlier

sudo docker-compose -f ./docker/clickhouse-setup/docker-compose.yaml up -d


For v0.5.1 (Released on 2 Dec 2021) and later

sudo docker-compose --env-file ./docker/clickhouse-setup/env/x86_64.env -f docker/clickhouse-setup/docker-compose.yaml up -d

How to instrument your own applications

The current docker-compose.yaml includes sample application (HotR.O.D) that generates tracing data. To see your own application data, follow the steps below

Checkout Instrumentation Section

Having issues running SigNoz?

Checkout Troubleshooting Section