#720 new defect

Changing web server address breaks CLI

Reported by: bewst Owned by:
Priority: major Milestone: undecided
Component: code-frontend-cli Version: 1.4.1
Keywords: docs wapi Cc:
Launchpad Bug:


I wanted to access the web UI of a node from other nodes on my local subnet, so I had

web.port = tcp:3456:interface=

where is the local web address. Unfortunately the result was commands like "tahoe ls" wouldn't work, because (?) they seem to get to the grid by going through the local node's WAPI instead of talking to the grid with whatever mechanism the WAPI itself uses.

Change History (2)

comment:1 Changed at 2009-05-31T21:01:11Z by warner

  • Component changed from unknown to code-frontend-cli
  • Owner nobody deleted

Yes.. partly that's by design. The CLI always talks to the local node's webapi: otherwise each CLI command would have to spin up a new client node, wait for it to connect to the introducer, learn about and connect to storage servers, etc. CLI commands are short-lived, but the long-running node acts like a daemon or agent for CLI and webapi requests.

The web.port specification allows you to control which interface the node will listen on (so you can restrict it to, but if you simply leave off the interface= part, it will listen on all interfaces. It sounds like you probably want to use:

web.port = tcp:3456

Each time the node starts up, it writes out NODEDIR/node.url with the fixed address of and the current port number (this makes it easier to write unit tests which use web.port=tcp:0 and ask the kernel to assign a free port each time). So node.url (and therefore the CLI) assumes that the tahoe client node will at least be listening on .

(you might also solve your problem by modifying node.url to point at, but since node.url is overwritten each time the node starts, you'd need to put your node somewhere other than ~/.tahoe . Simply removing the interface restriction sounds like a better solution).

Do you think it'd be enough to improve source:docs/configuration.txt to make it clear that interface= is optional, and that "tcp:3456" is the most likely value that you'd want to change web.port to have?

comment:2 Changed at 2010-06-12T22:34:00Z by davidsarah

  • Keywords docs wapi added

Should the gateway always listen on I can see why you would want to use interface to restrict to listening on, but why would you want to exclude the local interface?

Note: See TracTickets for help on using tickets.