slimctl slim start
Start a local SLIM node process. The node runs in the foreground until interrupted.
Usage
slimctl slim start [OPTIONS]
Examples
Start using a configuration file:
slimctl slim start --config data-plane/config/base/server-config.yaml
Start with TLS enabled:
slimctl slim start --config data-plane/config/tls/server-config.yaml
Start on a custom endpoint without a config file:
slimctl slim start --endpoint 127.0.0.1:12345
Note
When using --endpoint, the node starts without TLS using a minimal generated configuration.
Control log verbosity with the RUST_LOG environment variable:
RUST_LOG=debug slimctl slim start --config data-plane/config/base/server-config.yaml
Options
| Flag | Short | Default | Description |
|---|---|---|---|
--config |
-c |
— | Path to a SLIM server YAML configuration file |
--endpoint |
— | 127.0.0.1:46357 |
Server listen address. Cannot be used together with --config. |
--config and --endpoint are mutually exclusive. If neither is provided, the node starts on 127.0.0.1:46357 with a minimal default configuration.
Configuration File Examples
Sample configuration files are available in the config/ directory of the repository:
| Directory | Description |
|---|---|
base/ |
Plaintext, no authentication |
tls/ |
TLS-secured server |
mtls/ |
Mutual TLS authentication |
basic-auth/ |
HTTP Basic authentication |
jwt-auth-rsa/ |
JWT with RSA signing |
spire/ |
SPIFFE/SPIRE workload identity |
telemetry/ |
OpenTelemetry integration |
Inherited Options
Options inherited from slimctl slim:
No additional options.
Options inherited from slimctl:
| Flag | Short | Default | Description |
|---|---|---|---|
--config |
— | ~/.slimctl/config.yaml |
Path to slimctl client configuration file |
--server |
— | 127.0.0.1:46358 |
gRPC API endpoint |
--timeout |
— | 15s |
gRPC request timeout |
--basic-auth-creds |
-b |
— | Basic auth credentials (username:password) |
--tls.ca_file |
— | — | Path to TLS CA certificate |
--tls.cert_file |
— | — | Path to client TLS certificate |
--tls.key_file |
— | — | Path to client TLS private key |
--tls.insecure_skip_verify |
— | false |
Skip TLS certificate verification |
Note
The --config / -c option under slimctl slim start is the server configuration file for the SLIM node. The --config option inherited from slimctl is the client configuration file for slimctl itself. These are distinct.