peaceiris / docker-mdbook

mdBook Alpine Base Docker Image.

Alpine Base Docker Image for mdBook

Alpine base Docker Image for rust-lang/mdBook.

• peaceiris/mdbook - Docker Hub

Docker images on GitHub Packages ghcr.io/peaceiris/mdbook are also available.

Getting started

Image tag	Base Image	Image size	Notes
peaceiris/mdbook:v0.x.x	alpine:3.16	24MB	Minimum image
peaceiris/mdbook:v0.x.x-rust	rust:1.65-alpine3.16	880MB	mdbook test subcommand is available
ghcr.io/peaceiris/mdbook:v0.x.x	alpine:3.16	24MB	GitHub Packages: Minimum image
ghcr.io/peaceiris/mdbook:v0.x.x-rust	rust:1.65-alpine3.16	880MB	GitHub Packages: mdbook test subcommand is available

Docker Compose

Create your docker-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'

Usage

# Run "mdbook serve"
docker-compose up

# Run a command of mdBook
docker-compose run --rm mdbook init

GitHub Actions for mdBook

The mdBook Setup GitHub Action is recommended.

• peaceiris/actions-mdbook: GitHub Actions for mdBook (rust-lang/mdBook) ⚡️ Setup mdBook quickly and build your site fast. Linux (Ubuntu), macOS, and Windows are supported.

License

• MIT License - peaceiris/docker-mdbook

About the author

• peaceiris homepage