Files
puter/doc/contributors/extensions/dev-console.md
T
KernelDeimos 5433dde6d7 dev(extensions): [+] dev-socket
This extensions brings back the dev-socket functionality, which is
really important when testing things like broadcast, alarms, events, etc
; it saves a lot of time if you can invoke a command directly to the
backend.

This is an optional extension that will not be included in production
deployments. This is for development purposes only.
2026-02-03 19:39:07 -05:00

952 B
Raw Blame History

dev-console extension

The dev-console extension provides a dev socket so you can run backend commands on a local Puter instance (e.g. commands registered in CommandService).

Enabling

The extension is opt-in. Set the environment variable DEVCONSOLE=1 when starting Puter. The npm run dev script already does this:

npm run dev

With DEVCONSOLE=1, the extension registers a dev-socket service that creates a UNIX socket and runs command lines through CommandService.

Usage

See Backend dev socket for how to connect (e.g. rlwrap nc -U ./dev.sock) and run commands like help, logs:indent, etc.

Location

The extension lives in extensions/dev-console/. It only registers the dev-socket service when DEVCONSOLE=1; otherwise the extension loads but does nothing, so it does not affect default runs.