naoyoshinori/codex repository overview

⁠Quick Reference

• Where to get help:

  • Project's GitHub Issues⁠
  • The official Codex CLI documentation⁠
  • The Docker Community Forums⁠ or Stack Overflow⁠

• Supported Architectures:

  • linux/amd64, linux/arm64

• Supported tags and Dockerfile links:

  • 0-node-26-bookworm⁠
  • 0-node-26-bookworm-slim⁠
  • 0-node-24-bookworm⁠
  • 0-node, 0-node-24-bookworm-slim⁠
  • 0-node-22-bookworm⁠
  • 0-node-22-bookworm-slim⁠
  • 0-javascript-node-26-bookworm⁠
  • 0-javascript-node, 0-javascript-node-24-bookworm⁠
  • 0-javascript-node-22-bookworm⁠
  • 0-typescript-node-26-bookworm⁠
  • 0-typescript-node, 0-typescript-node-24-bookworm⁠
  • 0-typescript-node-22-bookworm⁠

⁠What is This Image?

A ready-to-use Docker environment for the OpenAI Codex CLI⁠ (@openai/codex).

This image allows you to use the Codex CLI without a local Node.js installation. Designed with security and convenience in mind, it runs as a non-root user and offers variants for different use cases, from minimal execution to a full development environment integrated with VS Code Dev Containers.

For a "Quick Start" guide, detailed documentation, and advanced examples, please visit the Docker for Codex GitHub repository⁠.

⁠Image Variants and Tags

This section details the available image variants and explains the tagging strategy to help you choose the right image for your needs.

⁠Recommended Tags

For most users, we recommend using one of the following tags. These point to the latest Codex CLI on the current Node.js LTS release (currently Node.js 24).

• naoyoshinori/codex:0-node (or 0-node-24-bookworm, 0-node-24-bookworm-slim)
  • A minimal image ideal for direct execution and CI/CD.
• naoyoshinori/codex:0-javascript-node (or 0-javascript-node-24-bookworm)
  • Includes common JavaScript development tools, recommended for VS Code Dev Containers.
• naoyoshinori/codex:0-typescript-node (or 0-typescript-node-24-bookworm)
  • Adds TypeScript-specific tools for a richer development environment.

Images for other Node.js versions are also available. Specify the full tag to use them:

• Node.js 26: 0-node-26-bookworm, 0-node-26-bookworm-slim, 0-javascript-node-26-bookworm, 0-typescript-node-26-bookworm
• Node.js 22: 0-node-22-bookworm, 0-node-22-bookworm-slim, 0-javascript-node-22-bookworm, 0-typescript-node-22-bookworm

⁠About Image Tags

All image tags follow the format below. Please note that a latest tag is not provided to encourage deliberate version selection.

Tag Format: <version>-<base_image> or <version>-<base_image>-<base_image_variant>

• <version>: The version of the Codex CLI (e.g., 0, 0.x).
• <base_image>: The base image name (node, javascript-node, or typescript-node).
• <base_image_variant> (Optional): A variant tag from the base image, which typically specifies the Node.js version and OS (e.g., 26-bookworm, 24-bookworm, 22-bookworm).

If you need to lock to a specific version for maximum reproducibility (e.g., in CI/CD), you can use a "fully-qualified tag" which includes the <base_image_variant>, such as 0-javascript-node-24-bookworm.

⁠License

• The OpenAI Codex CLI is licensed under the Apache 2.0 License⁠.
• The Dockerfile and associated scripts for this project are licensed under the MIT License⁠.
• As with all Docker images, this image contains other software under other licenses (e.g., the base OS distribution and its dependencies).