docker-base-debian

A custom base image built with Debian Linux.

Table Of Contents

• Features
• Configuration
  • Environment Variables
  • Volumes
    • /config
    • /root/.local/share/chezmoi

---

Features

• Python 3.13
  • pipx
  • poetry
    • poetry-dynamic-versioning
    • poetry-plugin-export
    • poetry-plugin-shell
  • yq
• multiple architectures
• non-root user (defaults to admin)
  • name, home directory, UID, and GID can be changed when the container is started
• bat
• chezmoi for dotfiles
• direnv
• jq
• nvm
• Oh My Zsh
  • zsh-autosuggestions
  • zsh-syntax-highlighting
  • zshrc.d
• oi
• s6-overlay

---

Configuration

Configuration is done through a combination of environment variables and volumes/bind mounts.

Environment Variables

Variable	Default	Description
_GID	568	GID of the non-root user group created and used by the container.
_UID	568	UID for the non-root user created and used by the container.
_USER	admin	Name of the non-root user created and used by the container.
CHEZMOI_REPO		Git repository that chezmoi will use to setup dotfiles. If not provided, dotfile are not setup.

Volumes

/config

The /config volume is used to store the majority of configuration files and persistant data.

/root/.local/share/chezmoi

While optional, a volume can be used to cache the chezmoi git repository.

services:
  service-name:
    volumes:
      - source: chezmoi-repo
        target: /root/.local/share/chezmoi
        type: volume

volumes:
  chezmoi-repo:
    driver: local
    labels:
      org.opencontainers.volume.description: Volume used to cache chezmoi dotfile repository.