3b8cff8b32
* Test GH pages * Add workflow * Maybe fix path * Restructure * Rename list file * Naming * Restructure again * Add readme, final touches * Add script to update PPA * Update change log * Update Makefile * Avoid commiting keys by accident * Documnet PPA_SIGNING_KEY in script
58 lines
1.4 KiB
Markdown
58 lines
1.4 KiB
Markdown
<!--
|
|
Copyright 2020 - Nym Technologies SA <contact@nymtech.net>
|
|
SPDX-License-Identifier: Apache-2.0
|
|
-->
|
|
|
|
# Nym Mixnode
|
|
|
|
A Rust mixnode implementation.
|
|
|
|
## Usage
|
|
|
|
* `nym-mixnode` prints a help message showing usage options
|
|
* `nym-mixnode run --help` prints a help message showing usage options for the run command
|
|
* `nym-mixnode run --layer 1 --host x.x.x.x` will start the mixnode in layer 1 and bind to the specified host IP address. Coordinate with other people in your network to find out which layer needs coverage.
|
|
|
|
By default, the Nym Mixnode will start on port 1789. If desired, you can change the port using the `--port` option.
|
|
|
|
## Install debian
|
|
|
|
```bash
|
|
sudo curl -s --compressed "https://nymtech.github.io/nym/nymtech.gpg" | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/nymtech.gpg > /dev/null
|
|
sudo echo "deb [signed-by=/etc/apt/trusted.gpg.d/nymtech.gpg] https://nymtech.github.io/nym/ /" > nymtech.list
|
|
|
|
sudo apt-get update
|
|
sudo apt-get install nym-mixnode
|
|
|
|
# See below for starting and managing the node
|
|
```
|
|
|
|
## Systemd support
|
|
|
|
```bash
|
|
sudo systemctl enable nym-mixnode
|
|
|
|
# Run
|
|
sudo systemctl start nym-mixnode
|
|
|
|
# Check status
|
|
sudo systemctl status nym-mixnode
|
|
|
|
# Logs
|
|
journalctl -f -u nym-mixnode
|
|
|
|
```
|
|
|
|
## Build debian package
|
|
|
|
```bash
|
|
# cargo install cargo-deb
|
|
|
|
# Build package
|
|
cargo deb -p nym-mixnode
|
|
|
|
# Install
|
|
|
|
# This will init the mixnode to `/etc/nym` as `nym` user, and create a systemd service
|
|
sudo dpkg -i target/debian/<PACKAGE>
|
|
``` |