Add docs for standalone config.toml (#190)

* Add docs for standalone config.toml

* Update docs/cli-reference/standalone-config.md

Co-authored-by: Phoebe Goldman <[email protected]>

* pre formatting

---------

Co-authored-by: Phoebe Goldman <[email protected]>

Author: coolreader18

docs/docs/cli-reference/standalone-config.md

@@ -0,0 +1,44 @@
+# `spacetimedb-standalone` configuration
+
+A local database instance (as started by `spacetime start`) can be configured in `{data-dir}/config.toml`, where `{data-dir}` is the database's data directory. This directory is printed when you run `spacetime start`:
+
+<!-- FIXME: handle bare <pre> better in markdown renderer -->
+<pre class="shiki"><span>spacetimedb-standalone version: 1.0.0
+spacetimedb-standalone path: /home/user/.local/share/spacetime/bin/1.0.0/spacetimedb-standalone
+database running in data directory <b>/home/user/.local/share/spacetime/data</b></span></pre>
+
+On Linux and macOS, this directory is by default `~/.local/share/spacetime/data`. On Windows, it's `%LOCALAPPDATA%\SpacetimeDB\data`.
+
+## `config.toml`
+
+- [`certificate-authority`](#certificate-authority)
+- [`logs`](#logs)
+
+### `certificate-authority`
+
+```toml
+[certificate-authority]
+jwt-priv-key-path = "/path/to/id_ecdsas"
+jwt-pub-key-path = "/path/to/id_ecdsas.pub"
+```
+
+The `certificate-authority` table lets you configure the public and private keys used by the database to sign tokens.
+
+### `logs`
+
+```toml
+[logs]
+level = "error"
+directives = [
+    "spacetimedb=warn",
+    "spacetimedb_standalone=info",
+]
+```
+
+#### `logs.level`
+
+Can be one of `"error"`, `"warn"`, `"info"`, `"debug"`, `"trace"`, or `"off"`, case-insensitive. Only log messages of the specified level or higher will be output; e.g. if set to `warn`, only `error` and `warn`-level messages will be logged.
+
+#### `logs.directives`
+
+A list of filtering directives controlling what messages get logged, which overwrite the global [`logs.level`](#logslevel). See [`tracing documentation`](https://docs.rs/tracing-subscriber/0.3/tracing_subscriber/filter/struct.EnvFilter.html#directives) for syntax. Note that this is primarily intended as a debugging tool, and log message fields and targets are not considered stable.

docs/docs/nav.js

@@ -17,6 +17,7 @@ const nav = {
         page('4 - Moving and Colliding', 'unity/part-4', 'unity/part-4.md'),
         section('CLI Reference'),
         page('CLI Reference', 'cli-reference', 'cli-reference.md'),
+        page('SpacetimeDB Standalone Configuration', 'cli-reference/standalone-config', 'cli-reference/standalone-config.md'),
         section('Server Module Languages'),
         page('Overview', 'modules', 'modules/index.md'),
         page('Rust Quickstart', 'modules/rust/quickstart', 'modules/rust/quickstart.md'),

docs/nav.ts

@@ -42,6 +42,11 @@ const nav: Nav = {
 
     section('CLI Reference'),
     page('CLI Reference', 'cli-reference', 'cli-reference.md'),
+    page(
+      'SpacetimeDB Standalone Configuration',
+      'cli-reference/standalone-config',
+      'cli-reference/standalone-config.md'
+    ),
 
     section('Server Module Languages'),
     page('Overview', 'modules', 'modules/index.md'),