WIP docs

internal/cli/start.go

@@ -148,7 +148,8 @@ func addExternalNetwork(filePath string) error {
 			"driver": "bridge",
 		},
 		"o11y": {
-			"external": true,
+			"name":       "o11y",
+			"attachable": true,
 		},
 	}
 	return writeDockerCompose(filePath, composeMap)

multi-compose.md

@@ -0,0 +1,34 @@
+# multi docker-compose setup
+
+In some cases user may want to integrate theirs own `docker-compose` with `run-o11-run`.
+
+To achieve this goal, please run `run-o11y-run` with `--external-network` flag
+
+```sh
+run-o11y-run start --external-network 
+```
+
+and modify your dockerfile to use `o11y` network like:
+
+```yaml
+networks:
+  o11y:
+    name: o11y
+    driver: bridge
+    external: true
+
+services:
+  foo:
+    image: ...
+    networks:
+      - o11y
+    environments:
+    - OTEL_EXPORTER_OTLP_ENDPOINT: run-o11y-run-otel-collector:43..
+
+  bar:
+    image: ...
+    networks:
+      - o11y
+    environemnts:
+    - OTEL_EXPORTER_OTLP_ENDPOINT: run-o11y-run-otel-collector:43..
+```