feat(casting): add Dokploy stack support

README.md

@@ -119,6 +119,7 @@ foundryctl cast -f casting.yaml
 | - | systemd | binary | [systemd/binary](docs/examples/systemd/binary/) |
 | ecs | ec2 | terraform | [ecs/ec2/terraform](docs/examples/ecs/ec2/terraform/) |
 | coolify | - | stack | [coolify/stack](docs/examples/coolify/stack/) |
+| dokploy | - | stack | [dokploy/stack](docs/examples/dokploy/stack/) |
 | railway | - | template | [railway/template](docs/examples/railway/template/) |
 | render | - | blueprint | [render/blueprint](docs/examples/render/blueprint/) |
 

api/v1alpha1/collectionagent/casting.schema.json

@@ -244,6 +244,7 @@
       "enum": [
         "render",
         "coolify",
+        "dokploy",
         "railway",
         "ecs",
         "aws",

api/v1alpha1/deployment_platform.go

@@ -19,6 +19,7 @@ var _ jsonschema.Enum = (*Platform)(nil)
 var (
 	PlatformRender  Platform = Platform{s: "render"}
 	PlatformCoolify Platform = Platform{s: "coolify"}
+	PlatformDokploy Platform = Platform{s: "dokploy"}
 	PlatformRailway Platform = Platform{s: "railway"}
 	PlatformECS     Platform = Platform{s: "ecs"}
 	PlatformAWS     Platform = Platform{s: "aws"}
@@ -38,6 +39,7 @@ func Platforms() []Platform {
 	return []Platform{
 		PlatformRender,
 		PlatformCoolify,
+		PlatformDokploy,
 		PlatformRailway,
 		PlatformECS,
 		PlatformAWS,

api/v1alpha1/deployment_platform_test.go

@@ -0,0 +1,14 @@
+package v1alpha1
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestPlatformDokployIsAvailable(t *testing.T) {
+	var platform Platform
+	require.NoError(t, platform.UnmarshalText([]byte("dokploy")))
+	require.Equal(t, "dokploy", platform.String())
+	require.Contains(t, Platforms(), PlatformDokploy)
+}

api/v1alpha1/installation/casting.schema.json

@@ -631,6 +631,7 @@
       "enum": [
         "render",
         "coolify",
+        "dokploy",
         "railway",
         "ecs",
         "aws",

docs/examples/README.md

@@ -9,5 +9,6 @@
 | - | systemd | binary | [systemd/binary](systemd/binary/) |
 | ecs | ec2 | terraform | [ecs/ec2/terraform](ecs/ec2/terraform/) |
 | coolify | - | stack | [coolify/stack](coolify/stack/) |
+| dokploy | - | stack | [dokploy/stack](dokploy/stack/) |
 | railway | - | template | [railway/template](railway/template/) |
 | render | - | blueprint | [render/blueprint](render/blueprint/) |

docs/examples/castings.json

@@ -42,6 +42,12 @@
       "flavor": "stack",
       "example": "coolify/stack"
     },
+    {
+      "platform": "dokploy",
+      "mode": "",
+      "flavor": "stack",
+      "example": "dokploy/stack"
+    },
     {
       "platform": "railway",
       "mode": "",

docs/examples/dokploy/README.md

@@ -0,0 +1,5 @@
+# Dokploy
+
+| Flavor | Description |
+| --- | --- |
+| [stack](stack/) | Deploy SigNoz on Dokploy as a Docker Swarm stack |

docs/examples/dokploy/stack/README.md

@@ -0,0 +1,62 @@
+# Dokploy Stack
+
+| Field | Value |
+| --- | --- |
+| **Mode** | `-` |
+| **Flavor** | `stack` |
+| **Platform** | `dokploy` |
+
+## Overview
+
+Generates a Docker Swarm `compose.yaml` and component configuration files for deployment through Dokploy's stack feature.
+
+> [!NOTE]
+> `foundryctl cast` does not deploy to Dokploy automatically. It generates the files and prints instructions for manual deployment.
+
+## Prerequisites
+
+- A [Dokploy](https://dokploy.com) instance
+- The external `dokploy-network` created by Dokploy
+
+## Configuration
+
+```yaml
+apiVersion: v1alpha1
+metadata:
+  name: signoz
+spec:
+  deployment:
+    flavor: stack
+    platform: dokploy
+```
+
+## Deploy
+
+```bash
+foundryctl forge -f casting.yaml
+```
+
+Set `SIGNOZ_DOMAIN` in Dokploy to the hostname that should serve the SigNoz UI, then deploy `pours/deployment/compose.yaml` with the stack feature. The generated Swarm labels configure HTTPS routing through Dokploy's Traefik service on container port `8080`. The SigNoz UI is the only service attached to Dokploy's shared network; databases remain isolated on the stack's private overlay network.
+
+The ingester ports are exposed to container networks but are not published directly on the host. Connect collectors running in the Swarm to the stack's private overlay network. To receive telemetry from outside the Swarm, use a patch to attach the ingester to an appropriate ingress network and configure routing for port `4318` (OTLP/HTTP).
+
+## Generated output
+
+```text
+pours/deployment/
+  compose.yaml
+  ingester/
+    ingester.yaml
+    opamp.yaml
+  telemetrykeeper/
+    clickhousekeeper/
+      keeper-0.yaml
+  telemetrystore/
+    clickhouse/
+      config-0-0.yaml
+      functions.yaml
+```
+
+## Customization
+
+For changes to the generated `compose.yaml`, use [patches](../../../concepts/patches.md).

docs/examples/dokploy/stack/casting.yaml

@@ -0,0 +1,8 @@
+apiVersion: v1alpha1
+kind: Installation
+metadata:
+  name: signoz
+spec:
+  deployment:
+    flavor: stack
+    platform: dokploy