Home

Welcome to the Runtime-Node Wiki!

Runtime-Node is a strictly distroless, scratch-based Docker environment engineered for running Node.js applications securely and efficiently.

Because we have eliminated the operating system layer entirely (no shell, no package manager, no OS utilities), developing and debugging for Runtime-Node requires a slightly different mindset than traditional node:alpine or node:debian images.

This Wiki serves as the definitive guide to mastering distroless Node.js deployments.

Table of Contents

1. Architecture Deep Dive - Understand exactly what is inside the image and why.
2. Handling Native Dependencies - How to use bcrypt, sharp, sqlite3, and other C++ add-ons.
3. Extending Runtime-Node - How to add custom system libraries in your Docker Image.
4. Debugging Without a Shell - Troubleshooting your app when /bin/sh doesn't exist.