Alpine-based Docker Images for rust-lang/mdBook.
Docker images on GitHub Packages ghcr.io/peaceiris/mdbook are also available.
CPU architectures amd64 and arm64 are supported.
Image tag (mdBook version) | Base Image | Image size | Notes |
---|---|---|---|
peaceiris/mdbook:v0.x.x |
alpine:3.20 |
30MB | Minimum image |
peaceiris/mdbook:v0.x.x-rust |
rust:1.78-alpine3.20 |
855MB | mdbook test subcommand is available |
ghcr.io/peaceiris/mdbook:v0.x.x |
alpine:3.20 |
30MB | GitHub Packages: Minimum image |
ghcr.io/peaceiris/mdbook:v0.x.x-rust |
rust:1.78-alpine3.20 |
855MB | GitHub Packages: mdbook test subcommand is available |
Create your compose.yml
like the following.
version: '3'
services:
mdbook:
container_name: mdbook
image: peaceiris/mdbook:v0.x.x # Minimum image
# image: peaceiris/mdbook:v0.x.x-rust # `mdbook test` subcommand is available
# image: ghcr.io/peaceiris/mdbook:v0.x.x # Docker images on GitHub Packages
stdin_open: true
tty: true
ports:
- 3000:3000
- 3001:3001
volumes:
- ${PWD}:/book
command:
- serve
- --hostname
- '0.0.0.0'
# Run "mdbook serve"
docker compose up
# Run a command of mdBook
docker compose run --rm mdbook init
The mdBook Setup GitHub Action is recommended.