EGL Headless

Open Beginner friendly
#640 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
82/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
linux
Domain
documentation

Research direction

Locate the tutorial section showing the EGL headless graphics configuration and review the existing example. Update it to mention that automatic render-node detection may fail on some setups, using the explicit /dev/dri/renderD128 example from the issue. Done means the tutorial explains when rendernode may need to be set manually.

Written by the indexing model from the issue text.

Description

The graphics configuration shown in the tutorial doesn't work for me on an RTX 3060:

<graphics type="egl-headless" port="-1" tlsPort="-1" autoport="yes">
  <gl enable="yes"/>
  <image compression="off"/>
</graphics>

Adding an explicit rendernode pointing to the correct DRI device fixed it:

<graphics type="egl-headless">
  <gl enable="yes" rendernode="/dev/dri/renderD128"/>
</graphics>

Might be worth updating the tutorial to mention that the render node sometimes needs to be set explicitly, since it's not auto-detected correctly on all setups (RTX 3060 in my case).

Dominant language
MDX
Stars
149
Forks
233
Avg merge
16h 24m
Merged PRs (30d)
9

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from CachyOS/wiki

All issues in CachyOS/wiki

Similar issues

More Documentation issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.