Opened at 2016-09-10T02:31:32Z
Closed at 2016-09-15T00:10:10Z
#2827 closed enhancement (fixed)
document new --location/--port / --hostname / --listen options
Reported by: | warner | Owned by: | warner |
---|---|---|---|
Priority: | normal | Milestone: | 1.12.0 |
Component: | documentation | Version: | 1.11.0 |
Keywords: | Cc: | ||
Launchpad Bug: |
Change History (6)
comment:1 Changed at 2016-09-10T02:33:37Z by warner
comment:2 Changed at 2016-09-13T14:04:53Z by dawuud
ok i started to write about these different network configuration scenarios here:
https://github.com/david415/tahoe-lafs/tree/2827.doc_cli_where_opts.0
while writing it i realized we really should make a client ipv6 handler then we can tell users how to configure ipv6-only storage nodes... no NAT penetration needed.
comment:3 Changed at 2016-09-14T11:47:47Z by dawuud
made a PR for your review: https://github.com/tahoe-lafs/tahoe-lafs/pull/344
comment:4 Changed at 2016-09-14T19:46:35Z by Brian Warner <warner@…>
In 8a4dc21/trunk:
comment:5 Changed at 2016-09-14T20:13:37Z by warner
I pushed some more docs in [d69757e]. I'm happy with --port/--location/--hostname now.
Next step is to implement --listen and document it.
comment:6 Changed at 2016-09-15T00:10:10Z by warner
- Resolution set to fixed
- Status changed from new to closed
[02ba2a05] added docs for --listen. We haven't enabled --listen=tor yet, but the docs are in place for it, so I think we can close this ticket now.
I'd like a docs/servers.rst with an explanation of the various network scenarios you might encounter (public-IP, firewall with port forwarding, unreachable but using an Onion service, etc). For each one, it should explain what you need to collect or allocate (hostnames, port numbers), what arguments to use when building the node, and how to perform any extra configuration.
This would also be a good place to point at the server-over-tor/i2p docs.