Node.js runtime image built on UDX Worker.

Quick Start • Usage • Development • Resources

Overview

UDX Worker Node.js is a Docker image that provides a ready-to-use Node.js runtime with the same operational model as udx/worker (https://github.com/udx/worker).

Quick Start

Requirements: Docker.

Run the published image with a Worker service config mounted into the container:

docker run --rm \
  -v "$(pwd)/src/examples/simple-server:/usr/src/app" \
  -v "$(pwd)/src/examples/simple-server/.config/worker:/home/udx/.config/worker:ro" \
  -p 8080:8080 \
  usabilitydynamics/udx-worker-nodejs:latest

Usage

• Worker runtime config: https://github.com/udx/worker/blob/latest/docs/config.md

• Service configuration: https://github.com/udx/worker/blob/latest/docs/services.md

• Runtime secrets: https://github.com/udx/worker/blob/latest/docs/secrets.md

• Local Worker config contract: docs/worker-config.md

Examples

• src/examples/simple-server is included as a minimal sample.

Development

git clone https://github.com/udx/worker-nodejs.git
cd worker-nodejs

make build
make test

To run a single test:

make run-test TEST_SCRIPT=10_validate_environment.sh

Build defaults for contributors live in Makefile.variables; the Node.js version is pinned in the Dockerfile NODE_VERSION argument.

Repo context generated by dev.kit repo lives in .rabbit/context.yaml; Rabbit-facing workflow notes live in .rabbit/README.md.

Resources

• Base image docs: https://github.com/udx/worker/tree/latest/docs
• Docker Hub: https://hub.docker.com/r/usabilitydynamics/udx-worker-nodejs

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to your branch
5. Open a Pull Request

Please ensure your PR includes appropriate tests and documentation updates.

---

Built by UDX © 2025