HUB
Sign inSign up
wokenv logo

frugan/wokenv

By frugan

•Updated about 2 hours ago

WordPress development environment with Node.js, Docker, and wp-env

Image
Developer tools
0

10K+

frugan/wokenv repository overview

Docker Pulls Docker Image Size Build Status GitHub Release License

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

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 Strategy

TagExampleDescription
latestlatestDefault Node.js version, latest wp-env (recommended)
node{N}node24Latest wp-env for a Node.js version
node{N}-wpenv{M}node24-wpenv12A 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.

⁠Quick Start

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

⁠What's Included

  • Node.js and npm
  • Docker CLI and Docker Compose
  • Git
  • wp-env, unmodified
  • js-yaml, used by the wokenv command to read wokenv.yml
  • An entrypoint that runs commands as the host user
⁠The entrypoint

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

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

⁠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., 12.x → 13.0), new tags are created

Every image is tested with tests/test.sh before it is pushed.

⁠Documentation

⁠Contributing

For your contributions please use:

See CONTRIBUTING⁠ for detailed guidelines.

⁠Sponsor

Buy Me A Coffee

⁠License

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

Tag summary

Content type

Image

Digest

sha256:c0ee99fe8…

Size

272.4 MB

Last updated

about 2 hours ago

docker pull frugan/wokenv