Skip to content

List the packages a clean Debian needs to build the Linux target - #3

Open
nejdetkadir wants to merge 1 commit into
geastack:mainfrom
nejdetkadir:docs/linux-build-dependencies
Open

nejdetkadir wants to merge 1 commit into
geastack:mainfrom
nejdetkadir:docs/linux-build-dependencies

Conversation

@nejdetkadir

Copy link
Copy Markdown

Problem

On a clean Debian install with only the packages the README lists, gea build --target raspberry-pi-os fails twice in a row:

  1. Native Linux runtime fonts require FreeType development package (freetype2) (build-raspberry-pi-os.sh, the pkg-config --exists freetype2 check)
  2. build-raspberry-pi-os.sh: line 275: file: command not found

The README also lists Debian's nodejs. @geastack/cli declares "node": ">=22"; Debian 12 ships 18, where gea fails at startup:

SyntaxError: The requested module 'node:util' does not provide an export named 'styleText'

Change

  • README.md, Dependencies: add libfreetype-dev and file, and a Node.js note.
  • targets/raspberry-pi-os/README.md: add both packages to the apt line.

Tests

Debian 13 (trixie) arm64 VM under OrbStack, starting from only the README packages, building a small fetch test app with the raspberry-pi-os target:

Packages Result
README list (Node 20.19.2) stops at the FreeType check
+ libfreetype-dev file: command not found
+ file [rpios] built …; ran under Xvfb, rendered and fetched over HTTPS
same, Node 22.23.3 builds, no EBADENGINE warnings

pkg-config is not listed separately because libcurl4-openssl-dev pulls it in (apt-cache rdepends). archive.raspberrypi.com bookworm (arm64) carries none of nodejs, file or libfreetype-dev, so Raspberry Pi OS takes them from Debian. I have not run this on a Raspberry Pi.

Not covered

Debian 12 and Raspberry Pi OS Bookworm still do not build with these packages: core's websocket_curl.cpp needs libcurl 8.2.0 or newer (geastack/core#76). I left Bookworm out of this change until that is settled.

On a fresh Debian 13 with only the listed packages, the build stopped at
the FreeType check and then at `file: command not found` on line 275 of
build-raspberry-pi-os.sh. With libfreetype-dev and file added it builds
and the app runs. pkg-config already comes with libcurl4-openssl-dev.

Debian 12's nodejs is 18 and cannot start gea; @geastack/cli declares
node >=22.
@coderabbitai

coderabbitai Bot commented Oct 20, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration
  • Configuration used: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 05aecea6-2b85-45a0-a1df-00ccb9c9d427
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

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.

1 participant