Deploying with Docker


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

Docker Installation Tutorial#

  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


This should install a tiny instance setting which runs with 4GB of memory. This is just for demo/testing purpose and not to be used in production.

To test if everything is fine, run the following command

docker ps

Output should look like this ( Should have 14 image names as shown below )

d23bcc11b54e signoz/flattener-processor:0.1.1 "./flattener" 2 minutes ago Up 2 minutes>8000/tcp flattener-processor
3fe13c96c4a5 otel/opentelemetry-collector:0.18.0 "/otelcol --config=/…" 2 minutes ago Up 2 minutes>1777/tcp,>14268/tcp,>55679/tcp,>55681/tcp,>8888/tcp,>13133/tcp,>55678/tcp docker_otel-collector_1
7fab07ba551b signoz/frontend:0.1.8 "nginx -g 'daemon of…" 4 minutes ago Up 4 minutes 80/tcp,>3000/tcp frontend
fd21e0fb04ee signoz/query-service:0.1.3 "./query-service" 4 minutes ago Up 4 minutes>8080/tcp query-service
485b9a6b1f68 apache/druid:0.20.0 "/ router" 4 minutes ago Up 4 minutes>8888/tcp router
061116e08ef4 apache/druid:0.20.0 "/ historical" 4 minutes ago Up 4 minutes>8083/tcp historical
89100a85e4f2 apache/druid:0.20.0 "/ middleMan…" 4 minutes ago Up 4 minutes>8091/tcp middlemanager
c18b08e8c0c1 apache/druid:0.20.0 "/ broker" 4 minutes ago Up 4 minutes>8082/tcp broker
3536502096f6 apache/druid:0.20.0 "/ coordinat…" 4 minutes ago Up 4 minutes>8081/tcp coordinator
7b22c4fc9aa4 bitnami/kafka:2.7.0-debian-10-r1 "/opt/bitnami/script…" 4 minutes ago Up 4 minutes (healthy)>9092/tcp docker_kafka_1
91e375b8c19b jaegertracing/example-hotrod:latest "/go/bin/hotrod-linu…" 4 minutes ago Up 4 minutes 8081-8083/tcp,>8080/tcp hotrod
c38e34c3f272 postgres:latest "docker-entrypoint.s…" 4 minutes ago Up 4 minutes 5432/tcp postgres
9b656aa85d7d grubykarol/locust:1.2.3-python3.9-alpine3.12 "/docker-entrypoint.…" 4 minutes ago Up 4 minutes 5557-5558/tcp,>8089/tcp load-hotrod
b939dd7dcc47 bitnami/zookeeper:3.6.2-debian-10-r100 "/opt/bitnami/script…" 4 minutes ago Up 4 minutes 2888/tcp, 3888/tcp,>2181/tcp, 8080/tcp docker_zookeeper_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.


If you face any issues here, don't worry - just check out the troubleshooting steps or join our slack communty

Production Settings#

A standard instance of SigNoz needs around 8GB of memory. The docker-compose.yaml file at deploy/docker/ can handle around 100RPS or 5K events/sec. Email at or join Slack for help in setting this up.

Troubleshooting of common issues#

  1. docker ps will show all containers created by SigNoz. Check if broker, otel-collector and historical containers are running. They do not come up if there is a memory problem. You may want to increase alloted memory.
  2. If you are still facing issues, try re-running ./ This will retry installing containers which failed the first time.
  3. Try reinstall SigNoz by first bringing down the existing containers by running sudo docker-compose -f docker/docker-compose-tiny.yaml down -v and then running ./
  4. If you are facing issues like Request failed with status code 400 in frontend, then open http://localhost:8888 or port 8888 on your IP .This is druid console. Check if Datasource named flattened_spans has come up. If there is no Ingestion Supervsor running, then run ./ again to bring them up.
  5. If you couldn't spot issues, feel free to join our slack community or shoot an email at We are generally always there.

Re-installing SigNoz#

  1. sudo docker-compose -f docker/docker-compose-tiny.yaml down -v
  2. ./

Troubleshooting for Mac users#

You need to check the memory allocated to docker. Follow below steps:

a) Choose the Docker menu whale menu > Preferences from the menu bar and configure the runtime options described below.

Docker Preferences

b) Choose Resources from Preferences Menu and change Memory to 3GB

Docker Resource Preferences

Configure docker-compose.yml#

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

How to instrument your own applications#

Checkout Instrumentation Section