Important
Experimental. This image is provided for feedback only. Its APIs
may change in any release, and it is not suitable for production use
yet. Suitable for experiments, exploration, and prototypes. See the
@cloudflare/computer status table
for which components are stable.
Docker image context for the prebuilt computerd linux-x64 binary.
computerd is the daemon side of @cloudflare/computer —
see docs/ for the wire protocol and architecture.
The binary is a Node single executable application. The Node runtime and
the FUSE addon are baked in. The unreleased binary on this branch links
system libfuse 3.17 or newer (fuse3 on Debian trixie) and needs Linux
6.9 or newer for local-only FUSE passthrough. The published 0.7.1 image
still links libfuse 2 and needs libfuse2t64. Both need /dev/fuse.
This package is private and is not published to npm. The release workflow
builds the binary, stages it into bin/computerd, and publishes the image
instead. This sample keeps both libfuse runtime packages until the
libfuse 3 binary is published:
FROM ghcr.io/cloudflare/computer-computerd-linux-x64:0.11.4 AS computerd
FROM debian:trixie-slim
RUN apt-get update \
&& apt-get install -y --no-install-recommends \
fuse3 libfuse2t64 ca-certificates \
&& rm -rf /var/lib/apt/lists/*
COPY --from=computerd /usr/local/bin/computerd /usr/local/bin/computerd
ENV PORT=8080 MOUNT_POINT=/workspace
EXPOSE 8080
ENTRYPOINT ["/usr/local/bin/computerd"]Pin the image version explicitly. latest is fine for experimentation but
can bite when wire-protocol changes land. The Next computerd image workflow
publishes ghcr.io/cloudflare/computer-computerd-linux-x64:next after
successful CI on the release branch. Use this mutable tag only for tests and
examples that intentionally track release candidates.
computerd reads its config from environment variables. The interesting ones:
| var | default | meaning |
|---|---|---|
PORT |
8080 |
HTTP + WebSocket listener port. |
MOUNT_POINT |
/workspace |
Path the FUSE filesystem mounts at. |
FUSE_MOUNT |
auto |
Backend selector. auto probes /dev/fuse (linux) or macFUSE (darwin) and falls back to the userspace shim. fuse and macfuse require their respective real backend. shim forces the userspace shim. none skips the mount entirely; HTTP / WS still come up. |