atelier/porthole/README.md
2025-04-12 00:32:30 -04:00

25 lines
829 B
Markdown

# porthole
`porthole` is a simple application to expose services running on your localhost
via some other host.
## Quickstart
To use `porthole`, you need to have the server running on a host that is exposed
to the WWW.
### Server
To configure the server, run `porthole server configure`. This will prompt you
for the configuration values you need.
Once configured, you can run `porthole server start` to launch the server.
### Client
To configure the client, run `porthole client configure`. This will prompt you
for the configuration values you need.
Once configured, you can run `porthole client start <local_port> [remote_port]`.
If everything goes well, this will print a `<hostname>:<port>` that should be
publically accessible!
**NOTE**: `[remote_port]` above is optional. If omitted, a random port will be
assigned.