# phusion/baseimage-docker

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/phusion-baseimage-docker).**

9,098 stars · 1,075 forks · Shell · MIT

## Links

- GitHub: https://github.com/phusion/baseimage-docker
- Homepage: http://phusion.github.io/baseimage-docker/
- awesome-repositories: https://awesome-repositories.com/repository/phusion-baseimage-docker.md

## Description

Phusion/baseimage-docker is a minimal Ubuntu-based Docker base image that includes a proper init system for managing multiple services and processes inside a single container. It provides a lightweight init process that reaps zombie processes, forwards stop signals for graceful shutdown, and supervises daemons through runit, restarting them automatically if they crash.

The image includes a preconfigured OpenSSH server restricted to public-key authentication for secure shell access to running containers, along with a cron daemon for scheduling recurring tasks. It supports ordered startup script execution, centralized environment variable injection that all services inherit, and package installation with automatic cache cleanup to minimize final image size. Additional utilities enable automated SSH login, container exec access, and one-shot command execution with full service initialization.

The base image forwards system logs to the console for observability, captures kernel and service messages, and provides user identity command execution without sudo. It is designed for running multiple daemons simultaneously within a single container, with clean service shutdown on stop signals and orphaned process reaping to prevent zombie accumulation.

## Tags

### DevOps & Infrastructure

- [Minimal Ubuntu Containers](https://awesome-repositories.com/f/devops-infrastructure/container-base-images/minimal-ubuntu-containers.md) — Boots a stripped-down operating system inside a container, omitting unnecessary services to reduce attack surface and image size. ([source](https://github.com/phusion/baseimage-docker/blob/master/Changelog.md))
- [Centralized Environment Variable Stores](https://awesome-repositories.com/f/devops-infrastructure/configuration-management/environment-management/environment-variable-management/environment-variable-configurations/environment-variable-configuration/centralized-environment-variable-stores.md) — Stores environment variables in a shared location so all startup scripts and services inherit them automatically. ([source](https://cdn.jsdelivr.net/gh/phusion/baseimage-docker@master/README.md))
- [Multi-Daemon Base Images](https://awesome-repositories.com/f/devops-infrastructure/container-build-orchestrators/cuda-aware-container-builders/ubuntu-base-image-builders/multi-daemon-base-images.md) — Provides an Ubuntu-based container image designed for running multiple daemons with process supervision and signal handling.
- [Container Shell Access](https://awesome-repositories.com/f/devops-infrastructure/container-hosting/container-shell-access.md) — Provides secure shell access to the container using key-based authentication with password login disabled by default. ([source](http://phusion.github.io/baseimage-docker/))
- [Multi-Process Base Images](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/container-runtimes/runtime-configuration-interfaces/docker-socket-orchestrators/docker-target-configurators/docker-container-deployments/docker-container-execution/repository-built-container-hook-runs/ready-to-run-docker-images/multi-process-base-images.md) — Provides a base image that supports running and supervising several daemons simultaneously within a single container.
- [Base Images with SSH Servers](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/container-runtimes/runtime-configuration-interfaces/docker-socket-orchestrators/docker-target-configurators/docker-container-deployments/docker-container-execution/repository-built-container-hook-runs/ready-to-run-docker-images/ssh-server-docker-images/base-images-with-ssh-servers.md) — Provides a Docker base image with a preconfigured SSH server for secure key-based access to running containers.
- [Graceful Shutdowns](https://awesome-repositories.com/f/devops-infrastructure/graceful-shutdowns.md) — Responds to stop signals by halting all running services cleanly before the container stops. ([source](http://phusion.github.io/baseimage-docker/))
- [Container Signal Forwarders](https://awesome-repositories.com/f/devops-infrastructure/graceful-shutdowns/container-signal-forwarders.md) — Catches container stop signals and forwards them to all managed services for clean deinitialisation before exit.
- [Multi-Daemon Container Managers](https://awesome-repositories.com/f/devops-infrastructure/oci-container-process-management/multi-daemon-container-managers.md) — Manages several daemons inside a single container, restarting them automatically if they crash. ([source](http://phusion.github.io/baseimage-docker/))
- [One-Shot Container Commands](https://awesome-repositories.com/f/devops-infrastructure/container-command-execution/one-shot-container-commands.md) — Executes a single command inside a new container after starting all system services and process supervisors. ([source](https://cdn.jsdelivr.net/gh/phusion/baseimage-docker@master/README.md))
- [Container Exec Logins](https://awesome-repositories.com/f/devops-infrastructure/container-orchestration/container-runtimes/runtime-configuration-interfaces/docker-socket-orchestrators/docker-target-configurators/docker-container-deployments/docker-container-execution/container-exec-logins.md) — Runs commands inside a running container using the built-in Docker tool without requiring an SSH daemon. ([source](https://cdn.jsdelivr.net/gh/phusion/baseimage-docker@master/README.md))
- [Package Installations with Cache Cleanup](https://awesome-repositories.com/f/devops-infrastructure/package-installations/package-installations-with-cache-cleanup.md) — Installs software packages and automatically clears the package cache afterward to keep the image small. ([source](https://cdn.jsdelivr.net/gh/phusion/baseimage-docker@master/README.md))
- [Recurring Job Scheduling](https://awesome-repositories.com/f/devops-infrastructure/recurring-job-scheduling.md) — Runs a cron daemon that executes scheduled tasks at configured times without manual intervention. ([source](http://phusion.github.io/baseimage-docker/))

### System Administration & Monitoring

- [Base Images with Init Systems](https://awesome-repositories.com/f/system-administration-monitoring/administrative-operations/linux-system-administration/init-systems/container-init-process/base-images-with-init-systems.md) — Provides a minimal Ubuntu base image with a proper init system for managing multiple services inside a container.
- [Container Init Process](https://awesome-repositories.com/f/system-administration-monitoring/administrative-operations/linux-system-administration/init-systems/container-init-process.md) — Ships a lightweight init process that reaps zombie processes and manages services inside Docker containers.
- [Process Supervision](https://awesome-repositories.com/f/system-administration-monitoring/process-supervision.md) — Supervises daemons through a lightweight process manager, restarting them automatically if they crash. ([source](https://cdn.jsdelivr.net/gh/phusion/baseimage-docker@master/README.md))

### Development Tools & Productivity

- [Orphaned Process Cleaners](https://awesome-repositories.com/f/development-tools-productivity/process-lifecycle-managers/orphaned-process-cleaners.md) — Cleans up orphaned child processes automatically to prevent zombie processes from accumulating over time. ([source](http://phusion.github.io/baseimage-docker/))
- [Container Startup Scripts](https://awesome-repositories.com/f/development-tools-productivity/startup-configurations/startup-script-bypass/terminal-startup-scripts/container-startup-scripts.md) — Executes all initialization scripts in order during container startup to set up the environment. ([source](https://cdn.jsdelivr.net/gh/phusion/baseimage-docker@master/README.md))
- [Cron Scheduling](https://awesome-repositories.com/f/development-tools-productivity/cron-scheduling.md) — Uses the traditional cron daemon to execute recurring tasks at configured times inside the container.

### Operating Systems & Systems Programming

- [Zombie Process Reclamation](https://awesome-repositories.com/f/operating-systems-systems-programming/kernel-core-internals/process-and-memory-management/memory-management/process-lifecycle-orchestrators/child-process-management-helpers/zombie-process-reclamation.md) — Runs a correct init process that automatically cleans up orphaned child processes to prevent zombie accumulation. ([source](https://cdn.jsdelivr.net/gh/phusion/baseimage-docker@master/README.md))

### Security & Cryptography

- [SSH Private Key Authentications](https://awesome-repositories.com/f/security-cryptography/private-key-import-formats/ssh-private-key-authentications.md) — Provides secure shell access for inspecting or administering a running container, restricted to key-based login only. ([source](https://cdn.jsdelivr.net/gh/phusion/baseimage-docker@master/README.md))
- [Secure SSH Access](https://awesome-repositories.com/f/security-cryptography/secure-ssh-access.md) — Provides a preconfigured OpenSSH server restricted to public-key authentication for secure container shell access.
- [Key-Only SSH Daemons](https://awesome-repositories.com/f/security-cryptography/ssh-key-management/key-only-ssh-daemons.md) — Runs an OpenSSH server restricted to public-key authentication for secure container shell access.

### Software Engineering & Architecture

- [Environment Variable Injection](https://awesome-repositories.com/f/software-engineering-architecture/application-lifecycle-management/configuration-management/environment-variable-management/environment-variable-injection.md) — Stores shared environment variables in a central file that all startup scripts and services source automatically.
