Install doc doesn't mention the port the server listens on

Open Beginner friendly
#8 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
84/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Quiet
Tech stack
javascript, node.js

Research direction

Start with the install guide’s server-start section, then verify the defaults in daveappserver and config.json. Update the documentation to state the HTTP port 1420 or PORT value and the WebSocket port 1462 or websocketPort value, including the reverse-proxy requirement.

Written by the indexing model from the issue text.

Description

Doing a test install using Claude Code, I noticed it took a long time for it to find the proper port to be proxied. Here is Claude's suggestion.

The install guide tells you to start the server with node rssnetwork.js and to set up a reverse proxy, but it never says what port to point that proxy at.

The answer is buried in daveappserver: the default is process.env.PORT || 1420, discoverable only by downloading the package and reading its source. Anyone following the guide who wants to put Caddy or nginx in front of the app has to go hunting for it.

A one-line addition to the install doc would fix this — either in the "Start the server" step or in a dedicated networking/ports section:

▎ The server listens on port 1420 by default (or the value of the PORT environment variable). Point your reverse proxy at that port.

It would also be worth mentioning the WebSocket port (1462 by default, set via websocketPort in config.json), since anyone running behind a reverse proxy needs to forward WebSocket upgrade requests to it separately.

Dominant language
JavaScript
Stars
37
Forks
7
PR merge metrics
No merged PRs in 30d

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 scripting/rss.chat

All issues in scripting/rss.chat

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.