stack

Coolify Stack

Field	Value
Mode	-
Flavor	stack
Platform	coolify

Overview

Generates a coolify.yaml stack definition for deploying SigNoz on a Coolify-managed server. Deployment is manual via the Coolify dashboard.

Note

foundryctl cast does not deploy to Coolify automatically. It generates the files and prints instructions for manual deployment.

Prerequisites

• A Coolify instance (self-hosted or cloud)

Configuration

apiVersion: v1alpha1
metadata:
  name: signoz
spec:
  deployment:
    flavor: stack
    platform: coolify

Deploy

# Generate the stack definition
foundryctl forge -f casting.yaml

After forging, deploy the generated coolify.yaml using the Coolify stack feature.

Generated output

pours/deployment/
  coolify.yaml

MCP server (optional)

Foundry can deploy the SigNoz MCP server alongside the stack so AI clients can query your telemetry. It is disabled by default; enable it in the casting:

apiVersion: v1alpha1
kind: Installation
metadata:
  name: signoz
spec:
  deployment:
    flavor: stack
    platform: coolify
  mcp:
    spec:
      enabled: true

This adds a signoz-mcp service to the stack listening on port 8000. Expose that port from the Coolify dashboard to reach it from AI clients; the MCP endpoint is the exposed URL plus /mcp.

To connect an AI client (mint an API key, configure Claude Code or Claude Desktop), see MCP server.

Customization

For changes to the generated coolify.yaml, use patches.