WordPress development environment with Node.js, Docker, and wp-env
10K+
Docker images for Wokenv - WordPress development environment with Node.js, Docker, and @wordpress/env package (wp-env) pre-configured.
Images published to Docker Hub: frugan/wokenv
Base: Alpine Linux
Node.js versions: 22, 24 (default)
wp-env version: 12 (major). wp-env 12 requires Node.js 22.13 or later.
| Tag | Example | Description |
|---|---|---|
latest | latest | Default Node.js version, latest wp-env (recommended) |
node{N} | node24 | Latest wp-env for a Node.js version |
node{N}-wpenv{M} | node24-wpenv12 | A Node.js version with a wp-env major version |
Tags with a -alpine, -bookworm or -trixie variant and tags for Node.js 18 and 20 belong to earlier releases and are no longer updated.
These images are meant to be used through the wokenv command, which mounts what wp-env needs. To select an image in a project:
# wokenv.yml
image: frugan/wokenv:node22
wokenv command to read wokenv.ymlWhen USER_ID and GROUP_ID are set, the entrypoint creates that user, adds it to the group that owns /var/run/docker.sock and runs the command as that user. wp-env then builds its images for the right user, and files created in mounted directories keep the right owner. Without those variables the command runs as root.
⚠️ 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 maps the host user into the container, 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.
Images are rebuilt daily to include:
Every image is tested with tests/test.sh before it is pushed.
For your contributions please use:
See CONTRIBUTING for detailed guidelines.
(ɔ) Copyleft 2026 Frugan.
GNU GPLv3, see LICENSE file.
Content type
Image
Digest
sha256:c0ee99fe8…
Size
272.4 MB
Last updated
about 2 hours ago
docker pull frugan/wokenv