Docker Standalone

Step 1: Install foundryctl

curl -fsSL https://signoz.io/foundry.sh | bash

For manual install (Windows PowerShell, air-gapped, etc.) or PATH setup, see the foundry getting-started guide.

Step 2: Create casting.yaml

Create a casting file that targets Docker with flavor: compose and mode: docker:

apiVersion: v1alpha1
kind: Installation
metadata:
  name: signoz
spec:
  deployment:
    flavor: compose
    mode: docker

For all configuration options, see the casting file reference and the Docker Compose example.

Step 3: Deploy

foundryctl cast -f casting.yaml

cast validates Docker, generates the Compose files into pours/deployment/, and starts the containers.

foundryctl gauge -f casting.yaml   # validate prerequisites
foundryctl forge -f casting.yaml   # generate compose files
cd pours/deployment && docker compose up -d

Step 4: Verify the installation

Check that the containers are running:

docker ps

The output should look similar to the following:

CONTAINER ID   IMAGE                                 COMMAND                  CREATED              STATUS                        PORTS                                                             NAMES
315e746cf0ff   clickhouse/clickhouse-server:25.5.6   "/entrypoint.sh"         About a minute ago   Up About a minute (healthy)   8123/tcp, 9000/tcp, 9009/tcp                                      signoz-telemetrystore-clickhouse-0-0
066dc6f6346f   postgres:16                           "docker-entrypoint.s…"   About a minute ago   Up About a minute (healthy)   5432/tcp                                                          signoz-metastore-postgres-0
e3b456480fe4   clickhouse/clickhouse-keeper:25.5.6   "/usr/bin/clickhouse…"   About a minute ago   Up About a minute (healthy)   2181/tcp, 9181/tcp, 10181/tcp, 44444/tcp                          signoz-telemetrykeeper-clickhousekeeper-0
51f763006ae0   signoz/signoz-otel-collector:latest   "/bin/sh -c '/signoz…"   About a minute ago   Up About a minute             0.0.0.0:4317-4318->4317-4318/tcp, [::]:4317-4318->4317-4318/tcp   signoz-ingester-1
c7550a1412d4   signoz/signoz:latest                  "./signoz server"        About a minute ago   Up About a minute (healthy)   0.0.0.0:8080->8080/tcp, [::]:8080->8080/tcp                       signoz-signoz-0

Once all containers are running, point your browser to http://<IP-ADDRESS>:8080/ to access the SigNoz UI — http://localhost:8080/ when SigNoz runs on your local machine.

Step 5: Enable the SigNoz MCP server (optional)

Foundry can also deploy the SigNoz MCP server alongside the stack so AI clients can query your telemetry. It is disabled by default.

1. Add an mcp block under spec in casting.yaml:

   apiVersion: v1alpha1
   kind: Installation
   metadata:
     name: signoz
   spec:
     deployment:
       flavor: compose
       mode: docker
     mcp:
       spec:
         enabled: true
   

2. Re-run cast to add the signoz-mcp service on port 8000:

   foundryctl cast -f casting.yaml
   

   Verify it is live:

   curl -fsS localhost:8000/livez && echo " OK"
   

3. Create an API key from a service account (Settings → Service Accounts, requires Admin role).

4. Add the server to your AI client. For example, with Claude Code:

   claude mcp add --scope user --transport http signoz http://localhost:8000/mcp \
     --header "SIGNOZ-API-KEY: <your-api-key>"
   

   • <your-api-key>: the key from step 3

   To confirm the connection, run /mcp inside Claude Code and check that the signoz server is listed as connected.

For other clients and example workflows, see SigNoz MCP Server and AI use cases.

Customize the installation

Every change follows the same loop: update casting.yaml, then re-run foundryctl cast to apply it.

• Component settings (image, replicas, environment): set them in the component's spec. For example, to pin SigNoz to a specific release, set its image to a version tag:

  spec:
    signoz:
      spec:
        image: signoz/signoz:v0.128.0
  

• Anything Foundry does not model (memory limits, networks, volumes): add patches under spec.patches. Do not edit the generated files in pours/ by hand — forge overwrites them.

docker compose -f pours/deployment/compose.yaml logs -f signoz-signoz-0

Step 1: Clone the SigNoz repository

In a directory of your choosing, clone the SigNoz repository and 'cd' into the signoz/deploy directory by entering the following commands:

git clone -b main https://github.com/SigNoz/signoz.git && cd signoz/deploy/

Step 2: Start the containers

To install SigNoz, enter the docker compose up command, specifying the following:

• -d to run containers in the background
• --remove-orphans to remove orphaned containers

cd docker
docker compose up -d --remove-orphans

Step 3: Verify the installation

Check that the containers are running:

docker ps

The output should look similar to the following:

CONTAINER ID   IMAGE                                   COMMAND                  CREATED              STATUS                        PORTS                                                             NAMES
e9baf4553644   signoz/signoz:v0.128.0                  "./signoz server"        About a minute ago   Up 36 seconds (healthy)       0.0.0.0:8080->8080/tcp, [::]:8080->8080/tcp                       signoz
4f2ecd9efd3c   signoz/signoz-otel-collector:v0.144.5   "/bin/sh -c '/signoz…"   About a minute ago   Up 36 seconds                 0.0.0.0:4317-4318->4317-4318/tcp, [::]:4317-4318->4317-4318/tcp   signoz-otel-collector
8743f2bfe97f   clickhouse/clickhouse-server:25.5.6     "/entrypoint.sh"         About a minute ago   Up About a minute (healthy)   8123/tcp, 9000/tcp, 9009/tcp                                      signoz-clickhouse
a1055af51110   signoz/zookeeper:3.7.1                  "/opt/bitnami/script…"   About a minute ago   Up About a minute (healthy)   2181/tcp, 2888/tcp, 3888/tcp, 8080/tcp                            signoz-zookeeper-1

Once all containers are running, point your browser to http://<IP-ADDRESS>:8080/ to access the SigNoz UI — http://localhost:8080/ when SigNoz runs on your local machine.

Install a specific version of SigNoz

To install a specific version, check out its release tag after cloning the repository (Step 1), then start the containers as in Step 2. For example, to install SigNoz version v0.128.0:

git checkout v0.128.0

docker compose logs -f signoz