naoyoshinori/gemini-cli

Quick Reference

• Where to get help:

  • https://github.com/naoyoshinori/docker-gemini-cli/issues
  • https://github.com/google-gemini/gemini-cli/blob/main/docs/index.md
  • The Docker Community Forums or Stack Overflow

• Supported Architectures:

  • linux/amd64, linux/arm64

• Supported tags and Dockerfile links:

  • https://github.com/naoyoshinori/docker-gemini-cli/blob/main/src/node/Dockerfile
  • https://github.com/naoyoshinori/docker-gemini-cli/blob/main/src/node/Dockerfile
  • https://github.com/naoyoshinori/docker-gemini-cli/blob/main/src/node/Dockerfile
  • https://github.com/naoyoshinori/docker-gemini-cli/blob/main/src/node/Dockerfile
  • https://github.com/naoyoshinori/docker-gemini-cli/blob/main/src/javascript-node/Dockerfile
  • https://github.com/naoyoshinori/docker-gemini-cli/blob/main/src/javascript-node/Dockerfile
  • https://github.com/naoyoshinori/docker-gemini-cli/blob/main/src/typescript-node/Dockerfile
  • https://github.com/naoyoshinori/docker-gemini-cli/blob/main/src/typescript-node/Dockerfile

What is This Image?

A ready-to-use Docker environment for https://github.com/google-gemini/gemini-cli (@google/gemini-cli).

This image allows you to use the Gemini 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 https://github.com/naoyoshinori/docker-gemini-cli.

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 stable version of their respective base images.

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

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 Gemini 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., 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 Google Gemini CLI is licensed under the https://github.com/google/generative-ai-go/blob/main/LICENSE.
• The Dockerfile and associated scripts for this project are licensed under the https://github.com/naoyoshinori/docker-gemini-cli/blob/main/LICENSE.
• As with all Docker images, this image contains other software under other licenses (e.g., the base OS distribution and its dependencies).