How to install custom Zsh themes in Docker with Zsh-in-Docker?

Use the -t flag with a Git URL in the RUN command, like '-t https://github.com/denysdovhan/spaceship-prompt'. The script clones and configures it, as shown in the README example with Spaceship.

Zsh-in-Docker or manual Oh My Zsh installation in Dockerfile?

Zsh-in-Docker is faster for standard setups with one-liner convenience, but manual installation offers more control over dependencies and steps for optimized or secure builds.

Can Zsh-in-Docker work with Alpine Linux without extra dependencies?

Yes, it supports Alpine, but you may need to ensure git and curl are installed first or use the -x flag. Alpine's minimal nature might require additional package management steps.

How to skip installing git and curl with Zsh-in-Docker?

Add the -x flag to the command, as noted in the README. Pre-install these dependencies in your Dockerfile to avoid permission issues, especially with non-root users.

Is Zsh-in-Docker secure for CI/CD pipelines?

It relies on downloading an external script, which can be a risk. Consider pinning to a specific version or auditing the script, and use in trusted networks only.

What themes come bundled with Zsh-in-Docker?

It includes Oh My Zsh bundled themes like robbyrussell, and defaults to powerlevel10k. Custom themes require Git URLs, as detailed in the -t option examples.

Open-Awesome

zsh-in-docker

MITShellv1.2.1

A script to install Zsh, Oh My Zsh, and plugins inside Docker containers with a single command.

GitHub

1.1k stars123 forks0 contributors

What is zsh-in-docker?

Zsh-in-Docker is a script that automates the installation of Zsh, Oh My Zsh, themes, and plugins inside Docker containers. It solves the problem of manually configuring a powerful shell environment in development containers, enabling a consistent and productive CLI experience across containerized workflows.

Target Audience

Developers and DevOps engineers who use Docker for development environments and want to enhance their container shell with Zsh and Oh My Zsh features, especially those using VSCode Remote Containers.

Value Proposition

It provides a one-command solution to set up a fully customized Zsh environment in Docker, saving time over manual installation and configuration while offering flexibility through theme and plugin options.

Overview

Install Zsh, Oh My Zsh and plugins inside a Docker container with one line!

Use Cases

Best For

Setting up Zsh in VSCode Remote Containers development environments
Automating shell environment configuration in Docker-based CI/CD pipelines
Creating consistent Zsh setups across team Docker development images
Quickly testing Oh My Zsh themes and plugins in isolated containers
Simplifying Dockerfile configuration for shell customization
Enhancing CLI productivity in containerized development workflows

Not Ideal For

Production containers where shell customization adds unnecessary overhead and security surface
Environments with strict air-gapped or offline build processes that cannot download scripts from GitHub
Teams standardized on Bash or other shells who prioritize consistency over Zsh features
Minimalist Docker images where installing git, curl, and Zsh significantly increases image size

Pros & Cons

Pros

One-Command Automation

Adds a single RUN command to Dockerfile to install Zsh, Oh My Zsh, themes, and plugins, eliminating manual steps as shown in the README examples.

Flexible Theme and Plugin Management

Supports bundled themes/plugins and custom Git URLs, allowing advanced customization like installing Spaceship theme or zsh-autosuggestions from GitHub.

Multi-Distribution Support

Works across Alpine, Ubuntu, Debian, Fedora, and other base images, making it versatile for diverse container environments.

Dependency Skip Option

Offers a -x flag to bypass installing zsh, git, and curl if pre-handled, giving control over Dockerfile layer management.

Cons

Non-Root User Hassles

The README admits issues with sudo permissions for non-root users, requiring manual dependency installation or sudo setup, adding complexity.

External Script Security Risk

Downloads and executes a script from GitHub without built-in verification, posing potential security and reliability concerns in sensitive environments.

Oh My Zsh Lock-In

Only supports Oh My Zsh framework, excluding alternatives like Prezto or Zim, which may limit users seeking different Zsh ecosystems.

Frequently Asked Questions

Related Projects

zoxide

A smarter cd command. Supports all major shells.

Stars39,894

Forks916

Last commit3 days ago

zsh-autosuggestions

Fish-like autosuggestions for zsh

Stars36,114

Forks1,939

Last commit1 year ago

zsh-syntax-highlighting

Fish shell like syntax highlighting for Zsh.

Stars23,017

Forks1,374

Last commit19 days ago

autojump

A cd command that learns - easily navigate directories from the command line

Stars16,962

Forks705