Skip to content

docs: drop sudo from rekordbox-mode run commands#23

Merged
vynulldev merged 1 commit into
mainfrom
docs-no-sudo
Jul 22, 2026
Merged

docs: drop sudo from rekordbox-mode run commands#23
vynulldev merged 1 commit into
mainfrom
docs-no-sudo

Conversation

@vynulldev

Copy link
Copy Markdown
Owner

What & why

rekordbox mode (the default) binds only unprivileged ports: the deck queries Pioneer's non-standard portmapper on UDP 50111, and the README's own "Port 111 (CDJ mode only)" section says exactly that. But the Web UI and Directory Mode examples and the Makefile run target all started with sudo anyway, teaching every new user to run the whole app as root for nothing. The Makefile even said "no privileged ports needed" one line above the sudo. Verified against nfs/portmap.go: the privileged port 111 bind is attempted only in CDJ mode.

sudo is dropped from the two rekordbox-mode README examples and the Makefile run target. The --mode cdj example keeps sudo, since CDJ-USB sources query the standard RPC portmapper on the privileged UDP 111, and gains a comment pointing at the sudo-free options (sysctl / setcap / iptables) already documented in the Requirements section.

Documentation and Makefile only; no code changes. The matching quick-start fix on the website shipped separately in the vynull-site repo.

Hardware testing

  • Tested on: N/A: docs and Makefile only, no code change.

Checklist

  • go build ./..., go vet ./..., and go test ./... pass
  • gofmt -l . is clean
  • New source files carry an SPDX header (GPL-3.0-or-later) (n/a, no new files)
  • Tested on real hardware (deck + firmware noted above), or this change doesn't affect deck behaviour
  • I agree my contribution is licensed under the project's GPLv3

rekordbox mode (the default) binds only unprivileged ports - the deck
queries Pioneer's non-standard portmapper on 50111, and the README's
own "Port 111 (CDJ mode only)" section says as much - but the Web UI
and Directory Mode examples and the Makefile run target all started
with sudo anyway, teaching every new user to run the whole app as root
for nothing. The Makefile even said "no privileged ports needed" one
line above the sudo.

Only --mode cdj needs UDP 111; that example keeps sudo with a comment
pointing at the sudo-free options (sysctl / setcap / iptables).
@vynulldev
vynulldev merged commit f939904 into main Jul 22, 2026
1 check passed
@vynulldev
vynulldev deleted the docs-no-sudo branch July 22, 2026 21:29
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