https://github.com/andriykalashnykov/dlib-docker
DLib Docker image for linux/amd64 and linux/arm64 with custom c++ and DLib build from sources
https://github.com/andriykalashnykov/dlib-docker
amd64 arm64 dlib dlib-face-detection dlib-face-recognition dlib-library dockerfile
Last synced: 2 months ago
JSON representation
DLib Docker image for linux/amd64 and linux/arm64 with custom c++ and DLib build from sources
- Host: GitHub
- URL: https://github.com/andriykalashnykov/dlib-docker
- Owner: AndriyKalashnykov
- License: cc0-1.0
- Created: 2024-10-15T23:14:56.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-04T07:04:59.000Z (2 months ago)
- Last Synced: 2026-04-04T09:12:45.582Z (2 months ago)
- Topics: amd64, arm64, dlib, dlib-face-detection, dlib-face-recognition, dlib-library, dockerfile
- Language: Makefile
- Homepage:
- Size: 171 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/AndriyKalashnykov/dlib-docker/actions/workflows/ci.yml)
[](https://github.com/AndriyKalashnykov/dlib-docker/releases/latest)
[](https://hits.sh/github.com/AndriyKalashnykov/dlib-docker/)
[](https://creativecommons.org/publicdomain/zero/1.0/)
[](https://app.renovatebot.com/dashboard#github/AndriyKalashnykov/dlib-docker)
# dlib-docker
Multi-platform Docker image for [DLib](https://github.com/davisking/dlib) (C++ machine learning toolkit). Builds for `linux/amd64`, `linux/arm64`, and `linux/arm/v7` from Ubuntu Noble with DLib compiled from source at a pinned upstream tag (`DLIB_VERSION` in the Makefile). The project's git tag matches the dlib version it ships — `v19.24.9` → dlib 19.24.9, `v20.0.1` → dlib 20.0.1.
| Component | Technology |
|-----------|-----------|
| Language | C++ (DLib toolkit) |
| Base Image | `ubuntu:noble-20260217` (digest-pinned) |
| DLib Source | Built from source at `v$DLIB_VERSION` (davisking/dlib tag) |
| Platforms | `linux/amd64`, `linux/arm64`, `linux/arm/v7` |
| Container Runtime | Docker + Buildx (multi-platform builder) |
| Dockerfile Linter | [hadolint](https://github.com/hadolint/hadolint) 2.14.0 |
| CI/CD | GitHub Actions + GHCR multi-arch push + GitHub Release |
| Dependency Updates | [Renovate](https://docs.renovatebot.com/) (branch automerge, squash) |
## Quick Start
```bash
make deps # verify Docker is installed
make build # build multi-platform image (creates buildx builder on first run)
make test # run container smoke test
make run # run the image interactively (amd64)
```
## Prerequisites
| Tool | Version | Purpose |
|------|---------|---------|
| [GNU Make](https://www.gnu.org/software/make/) | 3.81+ | Build orchestration |
| [Git](https://git-scm.com/) | latest | Version control |
| [Docker](https://www.docker.com/) | latest | Container runtime and buildx |
| [hadolint](https://github.com/hadolint/hadolint) | 2.14.0 | Dockerfile linting (auto-installed by `make lint`) |
| [act](https://github.com/nektos/act) | 0.2.87 | Run GitHub Actions locally (optional) |
| [nvm](https://github.com/nvm-sh/nvm) | 0.40.4 | Node.js for Renovate config validation (optional) |
Install all required dependencies:
```bash
make deps
```
## Available Make Targets
Run `make help` to see all available targets.
### Build & Run
| Target | Description |
|--------|-------------|
| `make build` | Build the dlib Docker image for all platforms |
| `make test` | Run container smoke test |
| `make lint` | Lint the Dockerfile with hadolint |
| `make static-check` | Composite quality gate (lint) |
| `make run` | Run the dlib Docker image interactively (amd64) |
| `make clean` | Remove build artefacts and temporary files |
### Docker
| Target | Description |
|--------|-------------|
| `make buildx-bootstrap` | Bootstrap multi-platform Docker buildx builder |
| `make image-run-amd64` | Run dlib image interactively (amd64) |
| `make image-run-arm64` | Run dlib image interactively (arm64) |
| `make image-run-armv7` | Run dlib image interactively (arm/v7) |
### CI
| Target | Description |
|--------|-------------|
| `make ci` | Run full CI pipeline (deps, static-check, build, test) |
| `make ci-run` | Run GitHub Actions workflow locally via [act](https://github.com/nektos/act) |
### Utilities
| Target | Description |
|--------|-------------|
| `make help` | List available tasks |
| `make deps` | Verify required toolchain dependencies |
| `make deps-hadolint` | Install hadolint for Dockerfile linting |
| `make deps-act` | Install act for local CI execution |
| `make release` | Create and push a new semver tag |
| `make tag-delete` | Delete a tag locally and from remote (TAG=vX.Y.Z) |
| `make renovate-bootstrap` | Install nvm and Node for Renovate |
| `make renovate-validate` | Validate Renovate configuration |
## Architecture
The build uses Docker Buildx with QEMU emulation to produce one image per platform. Each platform build runs natively inside its own emulated environment, so apt and the dlib compile both produce target-native binaries.
- **Base**: `ubuntu:noble-20260217` pinned by digest
- **dlib build**: downloaded via `curl` from `github.com/davisking/dlib/archive/refs/tags/v$DLIB_VERSION.tar.gz`, then `cmake -DBUILD_SHARED_LIBS=ON -DDLIB_USE_BLAS=ON -DDLIB_USE_LAPACK=ON` → `make install` → `ldconfig`
- **dlib deps** (from apt): OpenBLAS, BLAS, ATLAS, LAPACK, GSL CBLAS, GFortran, libjpeg-turbo, libpng, X11, GTK3 development headers; plus `build-essential`, `cmake`, `ca-certificates`, `curl`, `wget`, `net-tools` for the build and interactive use
- **Output** (under `/usr/local`): `libdlib.so`, `libdlib.so.$DLIB_VERSION`, `include/dlib/*`, `lib/cmake/dlib/*`, `lib/pkgconfig/dlib-1.pc`
- **Runtime user**: non-root `appuser` (uid 1000, gid 1000, home in `/home/appuser`). The default `ubuntu` user shipped by Noble's base image is removed first so `appuser` can take UID 1000.
- **Default CMD**: `tail -f /dev/null` — the image is a utility container; consumers `docker run` it with their own command or `-it ... /bin/bash`
On tag pushes (`v*`), CI builds and pushes all three platforms as a single multi-arch manifest to `ghcr.io//dlib-docker`, creates a GitHub Release with auto-generated notes, and tags the image with the bare-semver rollup set: `$DLIB_VERSION`, `$MAJOR.$MINOR`, `$MAJOR`, `latest`. Project convention: the git tag matches the dlib version it ships (e.g., git `v20.0.1` → dlib 20.0.1).
## CI/CD
GitHub Actions runs on every push to `main`, tag pushes `v*`, and pull requests.
| Job | Triggers | Steps |
|-----|----------|-------|
| **static-check** | push, PR, tags | Checkout, Static check (`make static-check` → hadolint) |
| **docker** | tag push (`v*`) | QEMU, Buildx, Log in to GHCR, Docker metadata, Build and push (multi-arch → `ghcr.io`) |
| **ci-pass** | always | Aggregates `static-check` + `docker` results for branch protection |
[Renovate](https://docs.renovatebot.com/) keeps dependencies up to date via platform branch automerge (squash strategy). A weekly `cleanup-runs.yml` workflow prunes old workflow runs and stale GitHub Actions caches.