Sync open source content 🐝 (from 22b8b1f2d39ea262b2bf4053ecfcc70056bbe03c)

Author: beezythebot

docs/speakeasy-reference/cli/docker.mdx

@@ -1,11 +1,11 @@
 ---
-description: "Use Speakeasy Docker images to generate SDKs and manage your API tooling in containerized environments. Includes all necessary build tools for supported languages."
+description: "Use Speakeasy Docker images to run CLI commands for validating OpenAPI specs, checking SDK status, and other non-generation tasks in containerized environments."
 slug: /speakeasy-cli/docker/
 ---
 
 # Using Speakeasy with Docker
 
-The Speakeasy Docker image provides a containerized environment for running Speakeasy CLI commands. The image includes all necessary build tools for all languages supported by Speakeasy, making it ideal for CI/CD pipelines and consistent development environments.
+The Speakeasy Docker image provides a containerized environment for running Speakeasy CLI commands. The image does not include language toolchains, so it cannot be used for SDK generation. Use it for other tasks like validating OpenAPI specs, checking SDK status, and running quickstart commands.
 
 ## Docker image
 
@@ -56,23 +56,6 @@ docker run -it -v "$(pwd):/workspace" -w "/workspace" \
 
 Create an API key in the [Speakeasy Platform](https://app.speakeasy.com) and set it as the `SPEAKEASY_API_KEY` environment variable.
 
-## Generate SDK
-
-To generate an SDK using the Docker image, mount your workspace directory and run the generation command:
-
-```bash
-docker run -it -v "$(pwd):/workspace" -w "/workspace" \
-    ghcr.io/speakeasy-api/speakeasy:latest run all --pinned --frozen-workflow-lockfile --output console
-```
-
-This command:
-- Mounts the current directory to `/workspace` in the container
-- Sets the working directory to `/workspace`
-- Runs all configured SDK generation workflows
-- Uses pinned versions for reproducibility
-- Uses a frozen workflow lockfile to ensure consistent dependencies
-- Outputs results to the console
-
 ## Common usage examples
 
 ### Run quickstart
@@ -93,15 +76,6 @@ docker run -it -v "$(pwd):/workspace" -w "/workspace" \
     ghcr.io/speakeasy-api/speakeasy:latest validate openapi -s ./openapi.yaml
 ```
 
-### Generate SDK for specific language
-
-Generate an SDK for a specific language:
-
-```bash
-docker run -it -v "$(pwd):/workspace" -w "/workspace" \
-    ghcr.io/speakeasy-api/speakeasy:latest run -t typescript
-```
-
 ### Check SDK status
 
 Check the status of your SDK generation:
@@ -111,42 +85,26 @@ docker run -it -v "$(pwd):/workspace" -w "/workspace" \
     ghcr.io/speakeasy-api/speakeasy:latest status
 ```
 
-## Included build tools
-
-The Speakeasy Docker image includes all necessary build tools for generating SDKs in the following languages:
-
-- TypeScript/JavaScript (Node.js, npm, pnpm, yarn)
-- Python (Python 3.x, pip, poetry)
-- Go (Go compiler and tools)
-- Java (JDK, Maven, Gradle)
-- C# (.NET SDK)
-- PHP (PHP runtime and Composer)
-- Ruby (Ruby runtime and Bundler)
-- Rust (Rust compiler and Cargo)
-
-This ensures that SDK generation works out of the box without requiring additional setup or dependencies.
-
 ## Using in CI/CD pipelines
 
-The Docker image is designed for use in CI/CD pipelines. Here's an example GitHub Actions workflow:
+The Docker image is designed for use in CI/CD pipelines. Here's an example GitHub Actions workflow for validating an OpenAPI spec:
 
 ```yaml
-name: Generate SDK
+name: Validate OpenAPI
 on:
   push:
     branches: [main]
 
 jobs:
-  generate:
+  validate:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
 
-      - name: Generate SDK
+      - name: Validate OpenAPI spec
         run: |
           docker run -v "$(pwd):/workspace" -w "/workspace" \
-            -e SPEAKEASY_API_KEY=${{ secrets.SPEAKEASY_API_KEY }} \
-            ghcr.io/speakeasy-api/speakeasy:latest run all --pinned --frozen-workflow-lockfile
+            ghcr.io/speakeasy-api/speakeasy:latest validate openapi -s ./openapi.yaml
 ```
 
 ## Volume mounts and permissions
@@ -170,17 +128,16 @@ If authentication fails, ensure that:
 
 ### File permission errors
 
-If you encounter file permission errors, try running the container with your user ID:
+If file permission errors occur, try running the container with the appropriate user ID:
 
 ```bash
 docker run -it --user $(id -u):$(id -g) \
     -v "$(pwd):/workspace" -w "/workspace" \
-    ghcr.io/speakeasy-api/speakeasy:latest run
+    ghcr.io/speakeasy-api/speakeasy:latest validate openapi -s ./openapi.yaml
 ```
 
 ### Network connectivity
 
-Ensure your Docker container has network access to:
+Ensure the Docker container has network access to:
 - The Speakeasy Platform (app.speakeasy.com)
-- Package registries for your target languages
-- Your OpenAPI specification source (if remote)
+- The OpenAPI specification source (if remote)