diff --git a/code-server/Dockerfile b/code-server/Dockerfile
index caa7430..e486900 100644
--- a/code-server/Dockerfile
+++ b/code-server/Dockerfile
@@ -19,6 +19,12 @@ RUN apt-get update \
     ncdu tmux restic rclone age hyperfine entr 7zip \
   && rm -rf /var/lib/apt/lists/*
 
+# Chromium and fonts for headless browser automation.
+RUN apt-get update \
+  && apt-get install -y --no-install-recommends \
+    chromium fonts-liberation fonts-noto-color-emoji fonts-noto-cjk \
+  && rm -rf /var/lib/apt/lists/*
+
 # Workspace directory, owned by the container user.
 RUN mkdir -p /workspace && chown 1000:1000 /workspace
 
diff --git a/code-server/README.md b/code-server/README.md
index ebfe18b..a407273 100644
--- a/code-server/README.md
+++ b/code-server/README.md
@@ -5,7 +5,7 @@ official `codercom/code-server` image.
 
 The image ships code-server on Debian with `git`, `zsh`, `curl`, `sudo` and a
 few editors. The `Dockerfile` adds `build-essential`, `bubblewrap`, `zip`,
-`unzip` and a set of command-line utilities, and wraps the entrypoint so it starts in `/workspace` and `coder` can
+`unzip`, a set of command-line utilities and Chromium, and wraps the entrypoint so it starts in `/workspace` and `coder` can
 use the Docker socket. Language toolchains and CLIs are installed into home,
 below.
 
@@ -251,6 +251,29 @@ Everything else lives in home rather than the image, so the image build stays
 small and a redeploy does not reinstall or upgrade tools behind your back;
 upgrading is the same commands run again.
 
+## Browser
+
+Debian's `chromium` is in the image so that browser-automation CLIs, such as
+agent-browser, can launch a headless browser inside the container, where they
+reach dev servers on `localhost`. Chrome for Testing, the browser those tools
+download by default, publishes no Linux ARM64 build, so the distro package is
+the install method on an ARM host. agent-browser finds `/usr/bin/chromium` on
+its own; no path variable is needed. Debian 13 ships Chromium through its
+security repository, so it stays within a release of upstream stable.
+
+`fonts-liberation`, `fonts-noto-color-emoji` and `fonts-noto-cjk` cover
+Latin, Vietnamese, emoji and CJK text in pages and screenshots; the base image
+ships almost no fonts. Together with Chromium they add about 850 MB to the
+image.
+
+There is no GPU. Headless Chromium renders in software, and WebGL runs on the
+SwiftShader backend that the package bundles, which works but is slow.
+
+`shm_size: 1gb` raises `/dev/shm`, the in-memory filesystem Chromium uses to
+pass rendered frames and data between its processes. Docker's default is
+64 MB, which makes tabs crash on heavy pages. The size is a ceiling, not a
+reservation: memory is used only while something is stored there.
+
 ## Shell
 
 `SHELL=/bin/zsh` in `compose.yml` picks the shell. The editor's terminal takes
diff --git a/code-server/compose.yml b/code-server/compose.yml
index 83ee647..ad0b7ba 100644
--- a/code-server/compose.yml
+++ b/code-server/compose.yml
@@ -3,6 +3,7 @@ services:
     build: .
     restart: unless-stopped
     hostname: ${SERVICE_HOSTNAME}
+    shm_size: 1gb
     environment:
       - PASSWORD=${PASSWORD:?required}
       - TZ=Asia/Ho_Chi_Minh