frugan/wokenv repository overview

⁠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.