You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# If you want to skip this step, run cargo build with the environment variable SKIP_BUILD_FRONTEND=true
41
+
# If you want to skip this step, build the packages with `cargo run -p build_packages -- --skip-build-frontend` to neglect building the frontends
45
42
46
-
# Build the runtime, along with a number of "distro" Wasm modules.
47
-
# The compiled binary will be at `kinode/target/debug/kinode`
48
-
# OPTIONAL: --release flag (slower build; faster runtime; binary at `kinode/target/release/kinode`)
43
+
# Build the "distro" Wasm modules, then, build the runtime.
44
+
# The compiled packages will be at `kinode/target/packages.zip`.
45
+
# The compiled binary will be at `kinode/target/debug/kinode`.
46
+
# OPTIONAL: --release flag (slower build; faster runtime; binary at `kinode/target/release/kinode`).
49
47
50
-
cargo +nightly build -p kinode
48
+
cd kinode
49
+
cargo run -p build_packages
50
+
cargo build -p kinode
51
51
```
52
52
53
+
[To build on Windows](https://gist.github.com/nick1udwig/f2d39a3fc6ccc7f7ad2912e8d3aeaae0)
54
+
53
55
## Security Status
54
56
55
57
No security audits of this crate have ever been performed. This software is under active development and should be **used at your own risk**.
@@ -58,14 +60,37 @@ No security audits of this crate have ever been performed. This software is unde
58
60
59
61
Make sure not to use the same home directory for two nodes at once! You can use any name for the home directory: here we just use `home`. The `--` here separates cargo arguments from binary arguments.
60
62
61
-
TODO: document feature flags in `--simulation-mode`
62
-
63
63
```bash
64
64
# OPTIONAL: --release flag
65
65
cargo +nightly run -p kinode -- home
66
66
```
67
67
68
-
On boot you will be prompted to navigate to `localhost:8080` (or whatever HTTP port your node bound to: it will try 8080 and go up from there, or use the port passed with the `--http-port` boot flag. Make sure your browser wallet matches the network that the node is being booted on. Follow the registration UI -- if you want to register a new ID you will either need Optimism ETH or an invite code.
68
+
On boot you will be prompted to navigate to `localhost:8080` or whatever HTTP port your node bound to: it will try 8080 and go up from there, or use the port passed with the `--port` boot flag. Make sure your browser wallet matches the network that the node is being booted on. Follow the registration UI -- if you want to register a new ID you will either need Optimism ETH or an invite code.
69
+
70
+
#### Boot Flags
71
+
72
+
Here are all the available boot flags for the Kinode runtime:
73
+
74
+
-`[home]`: (Required) Path to home directory.
75
+
-`-p, --port <PORT>`: Port to bind for HTTP. Default is the first unbound port at or above 8080.
76
+
-`--ws-port <PORT>`: Kinode internal WebSockets protocol port. Default is the first unbound port at or above 9000.
77
+
-`--tcp-port <PORT>`: Kinode internal TCP protocol port. Default is the first unbound port at or above 10000.
78
+
-`-v, --verbosity <VERBOSITY>`: Verbosity level: higher (up to 3)is more verbose. Default is 0.
79
+
-`-l, --logging-off`: Run in non-logging mode. Do not write terminal output to file in .terminal_logs directory.
80
+
-`-d, --detached`: Run in detached mode (don't accept input on terminal).
81
+
-`--rpc <RPC>`: Add a WebSockets Optimism RPC URL at boot.
82
+
-`--password <PASSWORD>`: Node password (in double quotes).
83
+
-`--max-log-size <MAX_LOG_SIZE_BYTES>`: Max size of all terminal logs in bytes. Setting to 0 means no size limit. Default is 16MB.
84
+
-`--number-log-files <NUMBER_LOG_FILES>`: Number of terminal logs to rotate. Default is 4.
85
+
-`--max-peers <MAX_PEERS>`: Maximum number of peers to hold active connections with. Default is 32.
86
+
-`--max-passthroughs <MAX_PASSTHROUGHS>`: Maximum number of passthroughs to serve as a router. Default is 0.
87
+
-`--soft-ulimit <SOFT_ULIMIT>`: Enforce a static maximum number of file descriptors. Default is fetched from system.
88
+
89
+
When compiled with the `simulation-mode` feature, two additional flags are available:
90
+
91
+
-`--fake-node-name <NAME>`: Name of fake node to boot.
92
+
-`--fakechain-port <FAKECHAIN_PORT>`: Port to bind to for local anvil-run blockchain.
93
+
69
94
70
95
## Configuring the ETH RPC Provider
71
96
@@ -88,6 +113,7 @@ This distribution of the OS also comes with userspace packages pre-installed. So
0 commit comments