mfahampshire
a70e68c7bd
* Smolmix documentation * Add smolmix docs: landing page, tutorials, and developer page links * Add Exit Gateway services page (NR vs IPR) and link from existing docs * Update auto-generated command and API outputs * Reorg of tutorials and architecture pages * License information + remove TODO from docs.rs visibile comment + reorg readme * Add versions file for doc-wide versioning * Relative -> absolute links * Relative -> absolute links * Update license + add old tutorial code as examples * Streamline smolmix docs * Clippy * Clean up doc comments * Last pass * Add larger file download to list * set new versions * Clippy * Remove blake pin from docs + add version range to root Cargo.toml * Format example logging * Remove crate blocked component * Loose whitespace * Add doc verification script for inline mdx * Formatting * Components regen * Reorg + tighten text * Voicing cohesion pass + remove bloated examples * Voicing cont. * Reduce max download size * Small suggested clarifications * Max/docs voicing consistency (#6769) * Reduce max download size * voicing consistency across docs * New landing order w smolmix * Tweaks * Final tweaks
61 lines
1.9 KiB
Plaintext
61 lines
1.9 KiB
Plaintext
# Usage
|
|
|
|
## Run
|
|
You can run the initialised client by doing this:
|
|
|
|
```
|
|
./nym-socks5-client run --id docs-example
|
|
```
|
|
|
|
## Automating your socks5 client with systemd
|
|
Create a service file for the socks5 client at `/etc/systemd/system/nym-socks5-client.service`:
|
|
|
|
```ini
|
|
[Unit]
|
|
Description=Nym Socks5 Client
|
|
StartLimitInterval=350
|
|
StartLimitBurst=10
|
|
|
|
[Service]
|
|
User=nym # replace this with whatever user you wish
|
|
LimitNOFILE=65536
|
|
ExecStart=/home/nym/nym-socks5-client run --id <your_id>
|
|
KillSignal=SIGINT
|
|
Restart=on-failure
|
|
RestartSec=30
|
|
|
|
[Install]
|
|
WantedBy=multi-user.target
|
|
```
|
|
|
|
Now enable and start your socks5 client:
|
|
|
|
```
|
|
systemctl enable nym-socks5-client.service
|
|
systemctl start nym-socks5-client.service
|
|
# you can always check your socks5 client has succesfully started with:
|
|
systemctl status nym-socks5-client.service
|
|
```
|
|
|
|
## Using your Socks5 Client
|
|
After completing the steps above, your local Socks5 Client will be listening on `localhost:1080` ready to proxy traffic to the Network Requester set as the `--provider` when initialising.
|
|
|
|
When trying to connect your app, generally the proxy settings are found in `settings->advanced` or `settings->connection`.
|
|
|
|
Here is an example of setting the proxy connecting in Blockstream Green:
|
|
|
|
|
|
|
|
Most wallets and other applications work the same way: find the network proxy settings and enter the proxy url (host: **localhost**, port: **1080**).
|
|
|
|
In some other applications, this might be written as **localhost:1080** if there's only one proxy entry field.
|
|
|
|
## Useful Commands
|
|
**no-banner**
|
|
|
|
Adding `--no-banner` startup flag will prevent Nym banner being printed even if run in tty environment.
|
|
|
|
**build-info**
|
|
|
|
A `build-info` command prints the build information (commit hash, rust version, binary version), the same as `--version`. You can also specify an `--output=json` flag that formats the whole output as JSON, which is much easier to parse.
|