Skip to content

Add linux/debian/README.md: packaging overview and headless service#3799

Open
mcfnord wants to merge 2 commits into
jamulussoftware:mainfrom
mcfnord:debian-readme
Open

Add linux/debian/README.md: packaging overview and headless service#3799
mcfnord wants to merge 2 commits into
jamulussoftware:mainfrom
mcfnord:debian-readme

Conversation

@mcfnord

@mcfnord mcfnord commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Requested by @ann0see in #3790 (comment) ("Add a README.md to linux/debian explaining this then").

One new file. Explains what deploy_deb.sh builds from this directory (the two packages and their qmake configs), notes that changelog is generated at build time, and documents jamulus-headless.service: what it runs, as which user, and where to configure it — linking to the server options page on jamulus.io rather than duplicating it.

CHANGELOG: SKIP

🤖 Generated with Claude Code

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Comment thread linux/debian/README.md Outdated
`linux/deploy_deb.sh` (run from the repository root) uses this directory to build two packages with `debuild`:

- **jamulus** — the desktop client/server (built with `CONFIG+=noupcasename`).
- **jamulus-headless** — a server-only binary (`CONFIG+=headless serveronly`) with no GUI library dependencies, plus a systemd service.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

noupcasename missing here?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Not missing — rules sets TARGET=jamulus-headless explicitly for that build, which overrides the target name directly (noupcasename only renames the default Jamulusjamulus). Updated the README to spell out both mechanisms so the asymmetry is clear.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Thanks.

I wonder why, though. Unless there's a good reason, we should be consistent. Is TARGET used elsewhere? (I mean, we added noupcasename specifically for Debian, if I remember correctly.)

pljones asked whether noupcasename was missing from the headless
package's config line. It is not: rules passes TARGET=jamulus-headless
explicitly there, which makes noupcasename redundant. State both
target-naming mechanisms in the README so the asymmetry is explained.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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.

2 participants