Wokenv Docker Images

Docker images for Wokenv - WordPress development environment with Node.js, Docker, and @wordpress/env package (wp-env) pre-configured.

Available Images

Images published to Docker Hub: frugan/wokenv

Variants:

• Alpine (recommended) - Lightweight, minimal footprint
• Bookworm (Debian 12) - Stable, full-featured
• Trixie (Debian 13) - Testing, latest features

Node.js versions: 18, 20 (LTS), 22

wp-env version: 10 (major)

Tag Strategy

Full Tags

Format: node{VERSION}-{VARIANT}-wpenv{VERSION}

# Alpine variants (default)
frugan/wokenv:node20-alpine-wpenv10
frugan/wokenv:node22-alpine-wpenv10
frugan/wokenv:node18-alpine-wpenv10

# Bookworm (Debian 12) variants
frugan/wokenv:node20-bookworm-wpenv10
frugan/wokenv:node22-bookworm-wpenv10

# Trixie (Debian 13) variants
frugan/wokenv:node20-trixie-wpenv10
frugan/wokenv:node22-trixie-wpenv10

Short Tags (Alpine only)

Format: node{VERSION}-wpenv{VERSION}

frugan/wokenv:node20-wpenv10   # Same as node20-alpine-wpenv10
frugan/wokenv:node22-wpenv10

Rolling Tags

frugan/wokenv:latest            # node20-alpine-wpenv10 (recommended)
frugan/wokenv:node20-latest     # Latest wpenv for Node 20
frugan/wokenv:node22-latest     # Latest wpenv for Node 22
frugan/wokenv:node20-lts        # Node 20 LTS (Bookworm variant)

Note: Tags are updated daily with latest OS patches and wp-env updates within the same major version.

Quick Start

# Pull latest image
docker pull frugan/wokenv:latest

# Or specific version
docker pull frugan/wokenv:node20-wpenv10

# Or specific variant
docker pull frugan/wokenv:node20-trixie-wpenv10

See Wokenv documentation for usage instructions.

What's Included

• Node.js (18, 20, or 22)
• npm
• Docker CLI and Docker Compose
• Git
• wp-env (pre-installed with patches)
• Automatic UID/GID permission handling

Important Notes

Docker User Namespace Remapping

⚠️ These images are NOT compatible with Docker userns-remap configurations.

If you have userns-remap enabled in your Docker daemon configuration (/etc/docker/daemon.json), you will experience permission issues. This is because wp-env requires specific user permissions that conflict with namespace remapping.

The entrypoint.sh script handles user/group ID mapping, but this approach is incompatible with Docker's user namespace remapping feature.

To check if you have userns-remap enabled:

docker info | grep "userns"

If you need user namespace remapping for security, these images are not suitable for your setup.

Platforms

• linux/amd64 (Intel/AMD)
• linux/arm64 (Apple Silicon, ARM)

Update Strategy

Images are rebuilt daily to include:

• Latest OS security patches
• Latest wp-env updates within same major version
• When wp-env major version changes (e.g., 10.x → 11.0), new tags are created

Documentation

• Wokenv Documentation
• Wokenv Docker Hub
• wp-env Documentation

Contributing

For your contributions please use:

• Conventional Commits
• Pull request workflow

See CONTRIBUTING for detailed guidelines.

Sponsor

License

(ɔ) Copyleft 2026 Frugan.
GNU GPLv3, see LICENSE file.