cli docker docs

Author: alexanderkirtzel

.changeset/fix-version-display.md

@@ -1,7 +1,6 @@
 ---
 '@walkeros/cli': minor
-'@walkeros/docker': minor
 ---
 
-Fix Docker runtime version display - versions now read reliably from
-package.json at runtime instead of fragile build-time injection
+CLI simplification - removed Docker mode for build commands, merged runtime from
+@walkeros/docker into CLI, single walkeros/flow image for production

apps/cli/package.json

@@ -18,7 +18,7 @@
     "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf dist"
   },
   "dependencies": {
-    "@walkeros/cli": "0.5.1-next.1"
+    "@walkeros/cli": "*"
   },
   "devDependencies": {
     "tsup": "^8.5.1",

package-lock.json

@@ -104,7 +104,6 @@ node packages/cli/dist/index.js run serve static-walker.js \
 ## Documentation
 
 - [CLI Documentation](../README.md)
-- [Docker Package](../../docker/README.md)
 
 ## Support
 

packages/cli/demos/README.md

@@ -301,7 +301,6 @@ The bundle is now ready to deploy!
 | `-s, --stats` | Show bundle statistics |
 | `--json` | Output statistics as JSON (for CI/CD) |
 | `--no-cache` | Skip package cache, download fresh |
-| `--local` | Execute locally without Docker |
 | `-v, --verbose` | Detailed logging |
 
 ### Multi-Flow Example
@@ -445,7 +444,6 @@ The simulation shows:
 | `--event <json>` | Event JSON string to test |
 | `--event-file <path>` | Path to JSON file with event(s) |
 | `--json` | Output as JSON |
-| `--local` | Execute locally without Docker |
 | `-v, --verbose` | Detailed logging |
 
 ### Multiple Events
@@ -482,7 +480,7 @@ Push is your bridge between local testing and production deployment.
 ### Basic Usage
 
 <CodeSnippet
-  code={`walkeros push flow.json --event '{"name":"page view","data":{"title":"Home"}}' --local`}
+  code={`walkeros push flow.json --event '{"name":"page view","data":{"title":"Home"}}'`}
   language="bash"
 />
 
@@ -542,7 +540,7 @@ Create `event.json`:
 **3. Push the event**
 
 <CodeSnippet
-  code={`walkeros push api-flow.json --event event.json --local --verbose`}
+  code={`walkeros push api-flow.json --event event.json --verbose`}
   language="bash"
 />
 
@@ -577,7 +575,6 @@ The event was sent to your real API endpoint!
 | `--json` | Output results as JSON |
 | `-v, --verbose` | Verbose output with debug information |
 | `-s, --silent` | Suppress output (for CI/CD) |
-| `--local` | Execute in local Node.js instead of Docker |
 
 ### Event Input Formats
 
@@ -619,7 +616,7 @@ The `--event` parameter accepts three formats:
 For CI/CD pipelines, use `--json` for machine-readable output:
 
 <CodeSnippet
-  code={`walkeros push flow.json --event '{"name":"page view"}' --json --silent --local`}
+  code={`walkeros push flow.json --event '{"name":"page view"}' --json --silent`}
   language="bash"
 />
 
@@ -652,10 +649,10 @@ Push to specific flows:
 
 <CodeSnippet
   code={`# Push to staging
-walkeros push flow.json --event event.json --flow staging --local
+walkeros push flow.json --event event.json --flow staging
 
 # Push to production
-walkeros push flow.json --event event.json --flow production --local`}
+walkeros push flow.json --event event.json --flow production`}
   language="bash"
 />
 
@@ -806,7 +803,6 @@ The collector terminal shows:
 | Option | Description |
 |--------|-------------|
 | `--port <number>` | Server port (default: 8080) |
-| `--local` | Execute locally without Docker |
 | `-v, --verbose` | Detailed logging |
 
 ### Running Pre-Built Bundles
@@ -945,7 +941,6 @@ Open `test.html` in your browser. Events will be sent to `http://localhost:8080/
 | `--port <number>` | Server port (default: 3000) |
 | `--path <string>` | URL path to serve script (default: `/`) |
 | `--name <string>` | Script filename (default: from config) |
-| `--local` | Execute locally without Docker |
 | `-v, --verbose` | Detailed logging |
 
 ## Complete example: Web → Server flow
@@ -1187,49 +1182,12 @@ These options work with all commands:
 
 | Option | Description |
 |--------|-------------|
-| `--local` | Execute without Docker (faster, requires local Node.js) |
 | `--verbose` | Show detailed logs |
 | `--silent` | Suppress output |
 | `--json` | Output as JSON (for CI/CD) |
 | `--help` | Show help for command |
 | `--version` | Show CLI version |
 
-## Execution modes
-
-### Docker Mode (Default)
-
-By default, the CLI uses Docker for isolated execution:
-
-<CodeSnippet
-  code={`walkeros bundle flow.json`}
-  language="bash"
-/>
-
-**Advantages**:
-- Consistent environment across machines
-- Isolated from local Node.js setup
-- Reproducible builds
-
-**Requirements**:
-- Docker installed and running
-
-### Local Mode
-
-Use `--local` to execute in your current Node.js environment:
-
-<CodeSnippet
-  code={`walkeros bundle flow.json --local`}
-  language="bash"
-/>
-
-**Advantages**:
-- Faster execution (no container startup)
-- No Docker dependency
-- Useful in CI/CD or containers
-
-**Requirements**:
-- Node.js 18+ installed locally
-
 ## CI/CD integration
 
 ### GitHub Actions
@@ -1264,12 +1222,14 @@ jobs:
 ### Docker Build
 
 <CodeSnippet
-  code={`FROM walkeros/cli:latest AS builder
+  code={`FROM node:18-alpine AS builder
+WORKDIR /build
+RUN npm install -g @walkeros/cli
 COPY flow.json .
-RUN walkeros bundle flow.json --local
+RUN walkeros bundle flow.json
 
-FROM walkeros/docker:latest
-COPY --from=builder /dist/bundle.mjs /app/flow.mjs
+FROM walkeros/flow:latest
+COPY --from=builder /build/dist/bundle.mjs /app/flow.mjs
 ENV MODE=collect
 ENV FLOW=/app/flow.mjs`}
   language="dockerfile"
@@ -1290,17 +1250,16 @@ npm ping`}
   language="bash"
 />
 
-### Docker Permission Issues
+### Build Issues
 
-On Linux, you may need to run Docker commands with sudo or add your user to the `docker` group:
+If you encounter build issues:
 
 <CodeSnippet
-  code={`# Use local mode instead
-walkeros bundle flow.json --local
+  code={`# Clear cache and retry
+walkeros cache clear
 
-# Or fix Docker permissions
-sudo usermod -aG docker $USER
-# Then log out and back in`}
+# Retry with verbose output
+walkeros bundle flow.json --verbose`}
   language="bash"
 />
 

website/docs/apps/cli.mdx

@@ -2,12 +2,12 @@
 title: Docker
 description: Deploy walkerOS flows with Docker containers
 sidebar_position: 3
-package: '@walkeros/docker'
+package: '@walkeros/cli'
 ---
 
 # walkerOS Docker
 
-The walkerOS Docker package (`@walkeros/docker`) is a **pure runtime container** for executing pre-built flow bundles in production. It's designed for fast startup (< 1 second), minimal footprint (~150-200MB), and cloud-native deployment.
+The walkerOS Docker image (`walkeros/flow`) is a **pure runtime container** for executing pre-built flow bundles in production. It's designed for fast startup (< 1 second), minimal footprint (~150-200MB), and cloud-native deployment.
 
 **Key Philosophy**: Docker handles runtime, [CLI](/docs/apps/cli) handles build-time. You bundle with the CLI, deploy with Docker.
 
@@ -42,7 +42,7 @@ The Docker image includes demo bundles for instant testing.
   code={`docker run -p 8080:8080 \\
   -e MODE=collect \\
   -e FLOW=/app/demos/demo-collect.mjs \\
-  walkeros/docker:latest`}
+  walkeros/flow:latest`}
   language="bash"
 />
 
@@ -65,7 +65,7 @@ The demo is self-contained and generates test events automatically.
   -e MODE=serve \\
   -e PORT=3000 \\
   -e STATIC_DIR=/app/demos \\
-  walkeros/docker:latest`}
+  walkeros/flow:latest`}
   language="bash"
 />
 
@@ -84,7 +84,7 @@ The Docker container is configured via environment variables:
   -e FLOW=/app/flow.mjs \\
   -e PORT=8080 \\
   -e HOST=0.0.0.0 \\
-  walkeros/docker:latest`}
+  walkeros/flow:latest`}
   language="bash"
 />
 
@@ -103,7 +103,7 @@ The Docker container is configured via environment variables:
   -e MODE=serve \\
   -e STATIC_DIR=/app/static \\
   -e PORT=3000 \\
-  walkeros/docker:latest`}
+  walkeros/flow:latest`}
   language="bash"
 />
 
@@ -138,7 +138,7 @@ This creates `dist/flow.mjs`.
   -e MODE=collect \\
   -e FLOW=/app/flow.mjs \\
   --name walkeros-collector \\
-  walkeros/docker:latest`}
+  walkeros/flow:latest`}
   language="bash"
 />
 
@@ -172,7 +172,7 @@ Build a custom Docker image with your bundle baked in.
 **2. Create Dockerfile**
 
 <CodeSnippet
-  code={`FROM walkeros/docker:latest
+  code={`FROM walkeros/flow:latest
 
 # Copy pre-built bundle
 COPY flow.mjs /app/flow.mjs
@@ -219,13 +219,14 @@ Build and bundle in a single Dockerfile.
 
 <CodeSnippet
   code={`# Build stage
-FROM walkeros/cli:latest AS builder
+FROM node:18-alpine AS builder
 WORKDIR /build
+RUN npm install -g @walkeros/cli
 COPY flow.json .
-RUN walkeros bundle flow.json --local --output flow.mjs
+RUN walkeros bundle flow.json --output flow.mjs
 
 # Runtime stage
-FROM walkeros/docker:latest
+FROM walkeros/flow:latest
 COPY --from=builder /build/flow.mjs /app/flow.mjs
 
 ENV MODE=collect
@@ -251,7 +252,7 @@ docker run -d -p 8080:8080 analytics-collector`}
 
 services:
   collector:
-    image: walkeros/docker:latest
+    image: walkeros/flow:latest
     environment:
       MODE: collect
       FLOW: /app/flow.mjs
@@ -285,7 +286,7 @@ docker-compose logs -f`}
 services:
   # Server-side event collection
   collector:
-    image: walkeros/docker:latest
+    image: walkeros/flow:latest
     environment:
       MODE: collect
       FLOW: /app/server-flow.mjs
@@ -297,7 +298,7 @@ services:
 
   # Web bundle serving
   tracker:
-    image: walkeros/docker:latest
+    image: walkeros/flow:latest
     environment:
       MODE: serve
       STATIC_DIR: /app/static
@@ -389,7 +390,7 @@ To start console-only: remove the `bigquery` destination block.
 **3. Create Dockerfile**
 
 <CodeSnippet
-  code={`FROM walkeros/docker:latest
+  code={`FROM walkeros/flow:latest
 COPY flow.mjs /app/flow.mjs
 ENV MODE=collect
 ENV FLOW=/app/flow.mjs
@@ -528,7 +529,7 @@ This creates `tracker.js`.
 **3. Create Dockerfile for serving**
 
 <CodeSnippet
-  code={`FROM walkeros/docker:latest
+  code={`FROM walkeros/flow:latest
 COPY tracker.js /app/static/tracker.js
 ENV MODE=serve
 ENV STATIC_DIR=/app/static
@@ -750,7 +751,7 @@ For sensitive configuration (API keys, credentials), use environment variables:
 
 <CodeSnippet
   code={`# Docker
-docker run -e BIGQUERY_KEY="$(cat key.json)" walkeros/docker
+docker run -e BIGQUERY_KEY="$(cat key.json)" walkeros/flow
 
 # Cloud Run
 gcloud run deploy $SERVICE_NAME \\
@@ -835,7 +836,7 @@ docker logs walkeros-collector`}
 
 <CodeSnippet
   code={`# Use a different host port
-docker run -p 8081:8080 walkeros/docker
+docker run -p 8081:8080 walkeros/flow
 
 # Or find and kill the conflicting process
 lsof -ti:8080 | xargs kill`}
@@ -846,13 +847,13 @@ lsof -ti:8080 | xargs kill`}
 
 <CodeSnippet
   code={`# Verify volume mount
-docker run -v $(pwd)/dist/flow.mjs:/app/flow.mjs walkeros/docker
+docker run -v $(pwd)/dist/flow.mjs:/app/flow.mjs walkeros/flow
 
 # Check if file exists in container
-docker run --rm -it walkeros/docker ls -la /app/
+docker run --rm -it walkeros/flow ls -la /app/
 
 # Verify FLOW environment variable
-docker run -e FLOW=/app/flow.mjs walkeros/docker`}
+docker run -e FLOW=/app/flow.mjs walkeros/flow`}
   language="bash"
 />
 
@@ -862,4 +863,4 @@ docker run -e FLOW=/app/flow.mjs walkeros/docker`}
 - **[Flow Configuration](/docs/getting-started/flow)** - Understand flow structure
 - **[Sources](/docs/sources/)** - Configure event sources
 - **[Destinations](/docs/destinations/)** - Set up analytics destinations
-- **[Docker Hub](https://hub.docker.com/r/walkeros/docker)** - Official Docker images
+- **[Docker Hub](https://hub.docker.com/r/walkeros/flow)** - Official Docker images