DevOps Building Blocks

awscli2

Sat, 06 Jun 2026 00:00:00 +0000

Current version: 0.1.0 | AWS CLI v2 documentation

Usage

"features": {
 "ghcr.io/devopsbuildingblocks/devcontainer-features/awscli2:0": {}
}

With options:

"ghcr.io/devopsbuildingblocks/devcontainer-features/awscli2:0": {
 "version": "2.22.0"
}

Options

Option	Type	Default	Description
`version`	string	`latest`	AWS CLI v2 version to install

Shell integration

Shell completion is configured automatically for both bash and zsh via aws_completer.

ubuntu-base

Wed, 20 May 2026 00:00:00 +0000

ubuntu-base is built on buildpack-deps:noble-curl (Ubuntu 24.04 LTS) and provides a clean foundation with the vscode non-root user and common development utilities installed via the common-utils feature.

Current version: 0.1.11

Usage

{
 "name": "My Project",
 "image": "ghcr.io/devopsbuildingblocks/devcontainer-images/ubuntu-base:latest"
}

Pin to a specific version:

{
 "image": "ghcr.io/devopsbuildingblocks/devcontainer-images/ubuntu-base:0.1.11"
}

What’s included

Base: buildpack-deps:noble-curl (Ubuntu 24.04)
Non-root user vscode (UID/GID 1000)
zsh as default shell
Persistent volume mounts for ~/.cache, ~/.local, and shell history
~/.shellrc.d/ framework for modular shell integration
Common build utilities: curl, git, xz, gzip

When to use this

Use ubuntu-base when you need a minimal Ubuntu starting point and plan to layer your own tooling via features or a custom Dockerfile. If you want Devbox for package management, start with ubuntu-devbox instead.

bat

Wed, 20 May 2026 00:00:00 +0000

Current version: 0.2.0 | bat on GitHub

Usage

"features": {
 "ghcr.io/devopsbuildingblocks/devcontainer-features/bat:0": {}
}

With options:

"ghcr.io/devopsbuildingblocks/devcontainer-features/bat:0": {
 "version": "0.26.1",
 "theme": "Dracula",
 "aliasAsCat": false
}

Options

Option	Type	Default	Description
`version`	string	`latest`	bat version to install
`aliasAsCat`	boolean	`true`	Alias `cat` to bat (plain style, no paging)
`theme`	string	`TwoDark`	Syntax highlighting theme

Available themes: Monokai Extended, Dracula, Nord, OneHalfDark, OneHalfLight, GitHub, gruvbox-dark, gruvbox-light, Solarized (dark), Solarized (light), TwoDark, Visual Studio Dark+, ansi, auto

Shell integration

Sets the BAT_THEME environment variable. Configures man to use bat as its pager for syntax-highlighted man pages.

ubuntu-devbox

Wed, 20 May 2026 00:00:00 +0000

ubuntu-devbox adds Nix and Devbox to ubuntu-base, giving you a reproducible package management layer before any tool-specific features are applied.

Current version: 0.1.14

Usage

{
 "name": "My Project",
 "image": "ghcr.io/devopsbuildingblocks/devcontainer-images/ubuntu-devbox:latest"
}

Pin to a specific version:

{
 "image": "ghcr.io/devopsbuildingblocks/devcontainer-images/ubuntu-devbox:0.1.14"
}

What’s included

Everything in ubuntu-base, plus:

Nix package manager
Devbox v0.16.0
VS Code terminal configured to open a devbox shell automatically
jetpack-io.devbox VS Code extension

When to use this

Use ubuntu-devbox when you want to manage your own toolset via a devbox.json in your project. On container start, devbox install runs automatically if a devbox.json is present. This is the recommended base for projects that need precise, per-project package pinning.

claude

Wed, 20 May 2026 00:00:00 +0000

Current version: 0.2.0 | Claude Code docs

Usage

"features": {
 "ghcr.io/devopsbuildingblocks/devcontainer-features/claude:0": {}
}

With options:

"ghcr.io/devopsbuildingblocks/devcontainer-features/claude:0": {
 "version": "1.5.0"
}

Options

Option	Type	Default	Description
`version`	string	`latest`	Claude Code version to install

What’s included

claude-code CLI installed via devbox global
anthropic.claude-code VS Code extension
~/.claude and ~/.claude.json symlinked to a persistent Docker volume

Config persistence

Claude Code stores its configuration, authentication, and conversation history in ~/.claude. This feature mounts a named Docker volume at /mnt/devcontainer-features/claude and symlinks ~/.claude there via a postCreateCommand script. Your Claude auth and settings survive container rebuilds without needing to re-authenticate each time.

ubuntu-toolbox

Wed, 20 May 2026 00:00:00 +0000

ubuntu-toolbox builds on ubuntu-devbox and layers in a curated set of modern CLI tools, all pre-configured with sensible defaults.

Current version: 0.1.6

Usage

{
 "name": "My Project",
 "image": "ghcr.io/devopsbuildingblocks/devcontainer-images/ubuntu-toolbox:latest"
}

Pin to a specific version:

{
 "image": "ghcr.io/devopsbuildingblocks/devcontainer-images/ubuntu-toolbox:0.1.6"
}

What’s included

Everything in ubuntu-devbox, plus:

Tool	Version	Description
`oh-my-posh`	26.23.6	Shell prompt theme engine
`eza`	0.23.4	Modern `ls` replacement
`bat`	0.26.1	`cat` with syntax highlighting
`fzf`	0.67.0	Fuzzy finder (CTRL-T, CTRL-R, ALT-C)
`delta`	0.18.2	Syntax-highlighting git diff pager
`lazygit`	0.57.0	Terminal UI for git

All tools are installed via devbox global and configured with shell aliases and integrations. delta is set as the default git pager. bat is aliased to cat. eza aliases replace ls, ll, la, lt, l.

common-utils

Wed, 20 May 2026 00:00:00 +0000

common-utils is the foundation feature that all other features in this collection depend on. It’s automatically included in all published images. You only need to add it explicitly if you’re building on a third-party base image.

Current version: 0.1.1

What’s included

User setup: Creates a non-root vscode user (UID 1000, GID 1000) with zsh as the default shell. VS Code is configured to use zsh in the integrated terminal.

Shell framework: Creates ~/.shellrc.d/, a directory where other features drop .sh scripts that are sourced automatically by both bash and zsh. This is how tool aliases, environment variables, and integrations are wired in without modifying ~/.bashrc or ~/.zshrc directly.

ubuntu-toolbox-nf

Wed, 20 May 2026 00:00:00 +0000

ubuntu-toolbox-nf is identical to ubuntu-toolbox but with Nerd Font icon support enabled in eza, lazygit, and oh-my-posh.

Current version: 0.1.6

Usage

{
 "name": "My Project",
 "image": "ghcr.io/devopsbuildingblocks/devcontainer-images/ubuntu-toolbox-nf:latest"
}

Pin to a specific version:

{
 "image": "ghcr.io/devopsbuildingblocks/devcontainer-images/ubuntu-toolbox-nf:0.1.6"
}

Differences from ubuntu-toolbox

Setting	ubuntu-toolbox	ubuntu-toolbox-nf
`oh-my-posh` theme	`db2-dark.minimal` (no icons)	`db2` (with icons)
`eza` icons	disabled	enabled (`--icons`)
`lazygit` file icons	disabled	enabled

Requirements

Your terminal emulator must have a Nerd Font configured, otherwise icons render as boxes or question marks. This is a terminal setting, not a container setting. Popular options: JetBrainsMono Nerd Font, FiraCode Nerd Font, MesloLGS NF.

delta

Wed, 20 May 2026 00:00:00 +0000

Current version: 0.2.0 | delta on GitHub

Usage

"features": {
 "ghcr.io/devopsbuildingblocks/devcontainer-features/delta:0": {}
}

With options:

"ghcr.io/devopsbuildingblocks/devcontainer-features/delta:0": {
 "version": "0.18.2",
 "theme": "Dracula",
 "features": "side-by-side"
}

Options

Option	Type	Default	Description
`version`	string	`latest`	delta version to install
`configureGit`	boolean	`true`	Set delta as git’s default pager
`theme`	string	`TwoDark`	Syntax highlighting theme
`features`	string	`default`	Delta display features

Available themes: auto, Dracula, GitHub, gruvbox-dark, gruvbox-light, Monokai Extended, Nord, OneHalfDark, Solarized (dark), Solarized (light), TwoDark

Available features: default, side-by-side, line-numbers, decorations

rocky-base

Wed, 20 May 2026 00:00:00 +0000

rocky-base mirrors ubuntu-base on a Rocky Linux 9 foundation, for environments where an RPM-based OS is required.

Current version: 0.1.5

Usage

{
 "name": "My Project",
 "image": "ghcr.io/devopsbuildingblocks/devcontainer-images/rocky-base:latest"
}

Pin to a specific version:

{
 "image": "ghcr.io/devopsbuildingblocks/devcontainer-images/rocky-base:0.1.5"
}

What’s included

Base: rockylinux:9
Non-root user vscode (UID/GID 1000)
zsh as default shell
Persistent volume mounts for ~/.cache, ~/.local, and shell history
Common build utilities: curl, git, xz, util-linux-user, glibc-langpack-en
LANG=en_US.UTF-8 locale set

When to use this

Use rocky-base when your production environment runs RHEL/Rocky Linux and you want a matching dev container base. For most projects with no OS constraint, the Ubuntu variants are recommended.

devbox

Wed, 20 May 2026 00:00:00 +0000

devbox is the foundational package management feature. All tool features in this collection install their software via devbox global add, so this feature (or an image that includes it) must be present.

Current version: 0.3.0 | Devbox

Usage

"features": {
 "ghcr.io/devcontainers/features/nix:1": {},
 "ghcr.io/devopsbuildingblocks/devcontainer-features/devbox:0": {}
}

With options:

"ghcr.io/devopsbuildingblocks/devcontainer-features/devbox:0": {
 "version": "0.16.0"
}

Options

Option	Type	Default	Description
`version`	string	`0.16.0`	Devbox version to install
`bin_dir`	string	`/usr/local/bin`	Directory to place the devbox binary

VS Code integration

The VS Code terminal is configured to open directly into a devbox shell:

rocky-devbox

Wed, 20 May 2026 00:00:00 +0000

rocky-devbox adds Nix and Devbox to rocky-base. Equivalent to ubuntu-devbox on Rocky Linux.

Current version: 0.1.6

Usage

{
 "name": "My Project",
 "image": "ghcr.io/devopsbuildingblocks/devcontainer-images/rocky-devbox:latest"
}

Pin to a specific version:

{
 "image": "ghcr.io/devopsbuildingblocks/devcontainer-images/rocky-devbox:0.1.6"
}

What’s included

Everything in rocky-base, plus:

Nix package manager (with filter-syscalls = false for Rocky Linux compatibility)
Devbox v0.16.0
VS Code terminal configured to open a devbox shell automatically
jetpack-io.devbox VS Code extension

direnv

Fri, 05 Jun 2026 00:00:00 +0000

Current version: 0.1.0 | direnv.net

Usage

"features": {
 "ghcr.io/devopsbuildingblocks/devcontainer-features/direnv:0": {}
}

With options:

"ghcr.io/devopsbuildingblocks/devcontainer-features/direnv:0": {
 "version": "2.35.0"
}

Options

Option	Type	Default	Description
`version`	string	`latest`	direnv version to install

What’s included

direnv installed via devbox global add
~/.config/direnv/config.toml created for both root and the remote user, whitelisting /workspaces
zsh shell hook configured automatically via ~/.shellrc.d/

/workspaces whitelist

On container creation, the feature writes the following config for each user:

[whitelist]
prefix = ["/workspaces"]

This means any .envrc file inside /workspaces is trusted automatically — no manual direnv allow required after a rebuild.

rocky-toolbox

Wed, 20 May 2026 00:00:00 +0000

rocky-toolbox is the Rocky Linux equivalent of ubuntu-toolbox, built on rocky-devbox.

Current version: 0.1.6

Usage

{
 "name": "My Project",
 "image": "ghcr.io/devopsbuildingblocks/devcontainer-images/rocky-toolbox:latest"
}

Pin to a specific version:

{
 "image": "ghcr.io/devopsbuildingblocks/devcontainer-images/rocky-toolbox:0.1.6"
}

What’s included

Everything in rocky-devbox, plus:

Tool	Version	Description
`oh-my-posh`	26.23.6	Shell prompt theme engine
`eza`	0.23.4	Modern `ls` replacement
`bat`	0.26.1	`cat` with syntax highlighting
`fzf`	0.67.0	Fuzzy finder
`delta`	0.18.2	Git diff pager
`lazygit`	0.57.0	Terminal UI for git

Configuration and shell aliases are identical to the Ubuntu toolbox variant.

eza

Wed, 20 May 2026 00:00:00 +0000

Current version: 0.2.0 | eza on GitHub

Usage

"features": {
 "ghcr.io/devopsbuildingblocks/devcontainer-features/eza:0": {}
}

With Nerd Font icons:

"ghcr.io/devopsbuildingblocks/devcontainer-features/eza:0": {
 "enableIcons": true
}

Options

Option	Type	Default	Description
`version`	string	`latest`	eza version to install
`theme`	string	`db2-dark`	Color theme
`aliasAsLs`	boolean	`true`	Replace `ls`, `ll`, `la`, `lt`, `l` with eza
`enableIcons`	boolean	`false`	Add `--icons` flag (requires Nerd Font)

Available themes: db2-dark, db2-light, none

Shell integration

When aliasAsLs=true, the following aliases are created:

Alias	Command
`ls`	`eza --color=always --group-directories-first`
`ll`	`eza -la --color=always --group-directories-first --git`
`la`	`eza -a --color=always --group-directories-first`
`lt`	`eza --tree --color=always --group-directories-first`
`l`	`eza -l --color=always --group-directories-first --git`

Commands: eza-themes, eza-theme <name>

rocky-toolbox-nf

Wed, 20 May 2026 00:00:00 +0000

rocky-toolbox-nf is identical to rocky-toolbox with Nerd Font icon support enabled. Equivalent to ubuntu-toolbox-nf on Rocky Linux.

Current version: 0.1.6

Usage

{
 "name": "My Project",
 "image": "ghcr.io/devopsbuildingblocks/devcontainer-images/rocky-toolbox-nf:latest"
}

Pin to a specific version:

{
 "image": "ghcr.io/devopsbuildingblocks/devcontainer-images/rocky-toolbox-nf:0.1.6"
}

Differences from rocky-toolbox

Setting	rocky-toolbox	rocky-toolbox-nf
`oh-my-posh` theme	`db2-dark.minimal` (no icons)	`db2` (with icons)
`eza` icons	disabled	enabled (`--icons`)
`lazygit` file icons	disabled	enabled

Requirements

fd

Wed, 20 May 2026 00:00:00 +0000

Current version: 0.1.0 | fd on GitHub

Usage

"features": {
 "ghcr.io/devopsbuildingblocks/devcontainer-features/fd:0": {}
}

With options:

"ghcr.io/devopsbuildingblocks/devcontainer-features/fd:0": {
 "enableAliases": false
}

Options

Option	Type	Default	Description
`version`	string	`latest`	fd version to install
`enableAliases`	boolean	`true`	Add useful fd aliases

Shell integration

When enableAliases=true:

Alias	Description
`fdi`	Case-insensitive search
`fdh`	Include hidden files
`fda`	Include hidden files and ignored files
`fde`	Search by file extension

fzf

Wed, 20 May 2026 00:00:00 +0000

Current version: 0.2.0 | fzf on GitHub

Usage

"features": {
 "ghcr.io/devopsbuildingblocks/devcontainer-features/fzf:0": {}
}

With a custom theme:

"ghcr.io/devopsbuildingblocks/devcontainer-features/fzf:0": {
 "theme": "dracula"
}

Options

Option	Type	Default	Description
`version`	string	`latest`	fzf version to install
`enableKeyBindings`	boolean	`true`	Enable shell key bindings
`enableCompletion`	boolean	`true`	Enable fuzzy tab completion
`theme`	string	`db2-dark`	Color theme
`defaultOptions`	string	`--height 40% --layout=reverse --border`	Sets `FZF_DEFAULT_OPTS`

Available themes: none, db2-dark, db2-light, tokyo-night, one-dark, dracula, catppuccin, nord, gruvbox

Key bindings

Binding	Action
`CTRL-T`	Find file in current directory, insert path at cursor
`CTRL-R`	Search shell history, run selected command
`ALT-C`	Find directory and `cd` into it

bat integration

When bat is also installed, CTRL-T automatically uses bat for syntax-highlighted file previews. No additional configuration needed.

gemini

Wed, 20 May 2026 00:00:00 +0000

Current version: 0.2.0 | Gemini CLI docs

Usage

"features": {
 "ghcr.io/devopsbuildingblocks/devcontainer-features/gemini:0": {}
}

With options:

"ghcr.io/devopsbuildingblocks/devcontainer-features/gemini:0": {
 "version": "0.1.20"
}

Options

Option	Type	Default	Description
`version`	string	`latest`	Gemini CLI version to install

What’s included

gemini-cli installed via devbox global
google.geminicodeassist VS Code extension
~/.gemini symlinked to a persistent Docker volume

Config persistence

Gemini CLI stores configuration and auth in ~/.gemini. This feature mounts a named Docker volume and symlinks ~/.gemini there, so authentication persists across container rebuilds.

helm

Sat, 06 Jun 2026 00:00:00 +0000

Current version: 0.1.0 | Helm

Usage

"features": {
 "ghcr.io/devopsbuildingblocks/devcontainer-features/helm:0": {}
}

With options:

"ghcr.io/devopsbuildingblocks/devcontainer-features/helm:0": {
 "version": "3.17.0"
}

Options

Option	Type	Default	Description
`version`	string	`latest`	Helm version to install

Shell integration

Shell completion is configured automatically for both bash and zsh.