Skip to content

Conversation

@ereslibre
Copy link
Collaborator

@ereslibre ereslibre commented Feb 3, 2026

Migrate the agent container base image from node:24-alpine (Alpine Linux) to node:lts (Debian). This switch to a glibc-based distribution reduces compatibility issues with prebuilt binaries and tools (e.g., Cursor Agent), minimizing the need for the nix-based glibc workaround (as glibc incompatibilities might still arise).

Closes: #493

Changes

Container image (Alpine → Debian)

  • Switched Dockerfile base image from node:24-alpine to node:lts
  • Replaced apk package commands with apt-get equivalents across all sandbox language, package manager, and task manager install scripts
  • Replaced corepack enable pnpm with npm install -g pnpm in the builder stage
  • Replaced wget with curl for downloading the package-manager-mcp binary
  • Replaced Alpine's uv package with the official uv install script
  • Updated sudoers files (1-sudoers-setup, 2-sudoers-cleanup) to reflect Debian's default group set
  • Changed the default shell from /bin/sh to /bin/bash in Docker and Podman sandbox shells
  • Replaced Alpine-specific Rust install (apk add rustup) with rustup.rs installer
  • Replaced Alpine-specific Just install with the official just install script
  • Updated network filtering script to use apt-get for iptables installation instead of apk

Other changes

  • Bumped package-manager-mcp-server version from v0.2.0 to v0.3.0
  • Agent process now explicitly exits with a proper exit code (0 on success, 1 on failure) after finishing the workflow
  • Updated documentation (agent-images.md, faq.md) to reflect the Debian base image

Notes

The nix-based glibc workaround previously needed for tools like the Cursor Agent is no longer required and has been removed from the documentation. The nix package itself is retained in the image for other purposes.

@ereslibre ereslibre marked this pull request as draft February 3, 2026 09:47
Copy link
Contributor

@Angelmmiguel Angelmmiguel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added a few comments! Great job 😄

@Angelmmiguel Angelmmiguel added this to the v2.1 milestone Feb 4, 2026
@ereslibre
Copy link
Collaborator Author

Okay, I have just run a sanity check with all supported agents, and it's looking good!

@ereslibre ereslibre marked this pull request as ready for review February 4, 2026 10:15
Copy link
Contributor

@Angelmmiguel Angelmmiguel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@ereslibre ereslibre merged commit daf5f54 into main Feb 4, 2026
6 checks passed
@ereslibre ereslibre deleted the ereslibre/migrate-base-image-to-debian branch February 4, 2026 10:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Migrate to using Debian-based agent image

3 participants