oblakstudio/mysql41 repository overview

⁠oblakstudio/mysql41

Legacy MySQL 4.1 (circa 2005) packaged for modern container workflows.

The image is built on Debian Sarge (3.1), which ships MySQL 4.1 (4.1.11a) as the mysql-server-4.1 package — pulled from archive.debian.org. (Sarge is the last Debian stable to carry 4.1; Etch moved to 5.0.) It is linux/386 and runs natively on amd64 hosts via Docker's multi-arch support. The entrypoint mirrors the official mysql image contract (env-driven first-run init, /docker-entrypoint-initdb.d), adapted to MySQL 4.1's SQL dialect.

⁠Tags

The wrapped MySQL is a fixed upstream (4.1.11); image releases are versioned independently with semantic versioning (driven by semantic-release⁠).

All tags are MySQL 4.1.11 on Debian Sarge, linux/386.

⁠Quick start

docker run --rm -d --name mysql41 \
  -e MYSQL_ROOT_PASSWORD=secret \
  -p 3306:3306 \
  oblakstudio/mysql41

On amd64 hosts you can add --platform=linux/386 (Docker usually infers it automatically).

⁠Environment variables

First-run initialization is controlled by these (same names as the official image):

Each variable also accepts a *_FILE form (e.g. MYSQL_ROOT_PASSWORD_FILE) for Docker secrets.

⁠Initialization scripts

Files placed in /docker-entrypoint-initdb.d/ run once, on first start (empty data dir):

• *.sql — piped into the server
• *.sql.gz — decompressed and piped in
• *.sh — sourced

docker run -d -e MYSQL_ROOT_PASSWORD=secret \
  -v ./seed.sql:/docker-entrypoint-initdb.d/seed.sql \
  oblakstudio/mysql41

⁠Data persistence

The data directory is /var/lib/mysql (declared as a volume). Mount a named volume to persist data; the entrypoint detects an existing data directory and skips re-initialization.

docker run -d -e MYSQL_ROOT_PASSWORD=secret -v mysql41data:/var/lib/mysql oblakstudio/mysql41

⁠Connecting — password hashing modes

MySQL 4.1 can store passwords in two formats, controlled by old_passwords in my.cnf⁠. This image defaults to old_passwords = 1 (the legacy pre-4.1 16-byte hash) so it behaves like older 4.x servers and the data sources these images typically resurrect.

To use MySQL 4.1's native 41-byte SHA1 hash instead (the format modern mysql_native_password clients understand, so --skip-secure-auth is not needed), set old_passwords = 0 in my.cnf before first-run init.

⁠Character sets

MySQL 4.1 introduced real charset/collation support; the server defaults to latin1 (latin1_swedish_ci). When restoring a legacy dump that declares DEFAULT CHARSET=latin1 and carries no SET NAMES, restore with --default-character-set=latin1 to preserve bytes exactly:

mysql -h127.0.0.1 -uroot -psecret --default-character-set=latin1 mydb < dump.sql

⁠Configuration

Server settings live in my.cnf⁠ (baked in at /etc/mysql/my.cnf). It binds 0.0.0.0 so the server is reachable across the Docker network and points the socket, PID, and datadir at the container paths. Override it by mounting your own file at the same path.

⁠Building from source

make build    # docker build --platform=linux/386 -t oblakstudio/mysql41 .
make run      # run locally for smoke testing (MYSQL_ROOT_PASSWORD=root)
make shell    # open a shell in the built image
make push     # publish :latest and :4.1.11 to Docker Hub
make help     # list all targets

Releases are automated in two stages:

• release.yml⁠ — on pushes to master, semantic-release⁠ derives the next image version from Conventional Commits⁠ and cuts a GPG-signed GitHub Release.
• docker_build.yml⁠ — when that release is published, docker/metadata-action + docker/build-push-action build with Buildx + QEMU and push the semver tags (plus :latest and :4.1.11) to Docker Hub, then peter-evans/dockerhub-description syncs this README into the Docker Hub repository description.

⁠How it works

MySQL 4.1 predates modern apt/yum repositories, so it cannot be installed from current distro package sources. The image is based on debian/eol:sarge-slim, whose sources.list already points at archive.debian.org, where apt-get install mysql-server-4.1 resolves to 4.1.11a-4sarge8. Sarge's apt (0.5.x) does not do GPG secure-apt, so the unsigned archive repo works as-is; a policy-rc.d returning exit 101 keeps the package's postinst from auto-starting the service during the build.

⁠Credits & License

Built and maintained by Oblak Studio⁠. MySQL is a trademark of Oracle Corporation; this image merely packages the long-released 4.1 server. The Dockerfile, entrypoint, and workflows in this repository are released under the MIT license.