Skip to main content
Version: 2.0.0

Command-Line Help for spacetime

This document contains the help content for the spacetime command-line program.

Command Overview:

spacetime​

Usage: spacetime [OPTIONS] <COMMAND>

Subcommands:​
  • publish — Create and update a SpacetimeDB database
  • env — Inspect published database environment variables
  • delete — Deletes a SpacetimeDB database
  • logs — Prints logs from a SpacetimeDB database
  • call — Invokes a function (reducer or procedure) in a database. WARNING: This command is UNSTABLE and subject to breaking changes.
  • describe — Describe the structure of a database or entities within it. WARNING: This command is UNSTABLE and subject to breaking changes.
  • dev — Start development mode with auto-regenerate client module bindings, auto-rebuild, and auto-publish on file changes.
  • sql — Runs a SQL query on the database. WARNING: This command is UNSTABLE and subject to breaking changes.
  • mcp — Serve SpacetimeDB to MCP-aware agents and editors over stdio. WARNING: This command is UNSTABLE and subject to breaking changes.
  • rename — Rename a database
  • generate — Generate client files for a spacetime module.
  • list — Lists the databases attached to an identity. WARNING: This command is UNSTABLE and subject to breaking changes.
  • login — Manage your login to the SpacetimeDB CLI
  • logout —
  • init — Initializes a new spacetime project.
  • build — Builds a spacetime module.
  • server — Manage the connection to the SpacetimeDB server. WARNING: This command is UNSTABLE and subject to breaking changes.
  • subscribe — Subscribe to SQL queries on the database. WARNING: This command is UNSTABLE and subject to breaking changes.
  • start — Start a local SpacetimeDB instance
  • lock — Lock a database to prevent accidental deletion
  • unlock — Unlock a database to allow deletion
  • auth — Manage SpacetimeAuth for a database
  • version — Manage installed spacetime versions
Options:​
  • --root-dir <ROOT_DIR> — The root directory for SpacetimeDB files. If you installed with --root-dir, pass the same value on each command, before the subcommand (for example, spacetime --root-dir /stdb start).
  • --config-path <CONFIG_PATH> — The path to the cli.toml config file

spacetime publish​

Create and update a SpacetimeDB database

Usage: spacetime publish [OPTIONS] [name|identity]

Publishing preserves unspecified environment values. Put an env map in spacetime.json in order to specify variables in config. Explicit keys which are not declared in the module are allowed. Declared shell variables override config values (including empty strings). The CLI displays supplied keys and sources. --env-only updates an existing database's environment without publishing the module. --unset-env explicitly removes a previously published environment variable, unless the variable is declared required by the currently published module. --replace-env replaces all stored values with the supplied set, including deleting unspecified undeclared keys, and cannot be combined with --unset-env. The host validates the resulting environment atomically against the declared module. --env selects which config file to use.

Arguments:​

  • <NAME|IDENTITY> — A valid domain or identity for this database.

    Database names must match the regex /^[a-z0-9]+(-[a-z0-9]+)*$/, i.e. only lowercase ASCII letters and numbers, separated by dashes.

Options:​

  • -c, --delete-data <CLEAR-DATABASE> — When publishing to an existing database identity, first DESTROY all data associated with the module. With 'on-conflict': only when breaking schema changes occur.

    Possible values: always, on-conflict, never

  • --build-options <BUILD_OPTIONS> — Options to pass to the build command, for example --build-options='--lint-dir='

    Default value: ``

  • -p, --module-path <MODULE_PATH> — The system path (absolute or relative) to the module project. Defaults to spacetimedb/ subdirectory, then current directory.

  • -b, --bin-path <WASM_FILE> — The system path (absolute or relative) to the compiled wasm binary we should publish, instead of building the project.

  • -j, --js-path <JS_FILE> — UNSTABLE: The system path (absolute or relative) to the javascript file we should publish, instead of building the project.

  • --break-clients — Allow breaking changes when publishing to an existing database identity. Equivalent to --yes=break-clients: skips the "this will BREAK existing clients" prompt, but will NOT force publish if it would cause deletion of any data in the database. See --yes and --delete-data for details.

  • --anonymous — Perform this action with an anonymous identity

  • --parent <PARENT> — A valid domain or identity of an existing database that should be the parent of this database.

    If a parent is given, the new database inherits the team permissions from the parent. A parent can only be set when a database is created, not when it is updated.

  • --organization <ORGANIZATION> — The name or identity of an existing organization this database should be created under.

    If an organization is given, the organization member's permissions apply to the new database. An organization can only be set when a database is created, not when it is updated.

  • -s, --server <SERVER> — The nickname, domain name or URL of the server to host the database.

  • -y, --yes <YES> — Skip confirmation prompts. With no value, defaults to 'all' (equivalent to --yes=all). To skip specific prompts, pass one or more of: all, remote, migrate, break-clients, skip-login, delete-data. Multiple values can be comma-separated (--yes=migrate,break-clients) or given via repeated flags (--yes=migrate --yes=break-clients). The value must be attached with '=' (so --yes my-db treats my-db as the database name).

    Possible values:

    • all: Equivalent to passing every other option. This is the default when --yes is given without a value
    • remote: Skip the "publish to a non-local server?" confirmation
    • migrate: Skip migration confirmations (e.g. major version upgrade)
    • break-clients: Skip the "this will BREAK existing clients" confirmation
    • skip-login: Don't prompt the user to log in; act non-interactively for auth
    • delete-data: Skip the destructive "this will DESTROY ... ALL corresponding data" confirmation

  • --no-config — Ignore spacetime.json configuration

  • --env <ENV> — Environment name for config file layering (e.g., dev, staging)

  • --native-aot — Use NativeAOT-LLVM compilation for C# modules (experimental; supported on Windows, and on Linux with .NET 10)

  • --dotnet-version <VERSION> — Target .NET SDK major version for C# projects (e.g. 8 or 10). Auto-detected when omitted.

  • --env-only — Update environment values without building or uploading a module.

  • --unset-env <KEY> — Delete an environment value. Repeat for multiple keys.

  • --replace-env — Replace all environment values, deleting every unspecified key.

spacetime env​

Inspect published database environment variables

Usage: spacetime env <COMMAND>

Subcommands:​
  • get — Read one published environment value
  • list — List published environment keys and values

spacetime env get​

Read one published environment value

Usage: spacetime env get [OPTIONS] <database> <key>

Arguments:​
  • <KEY> — The stored environment key to read
  • <DATABASE> — The database name, identity, or configured target
Options:​

  • -s, --server <SERVER> — The nickname, host name or URL of the server

  • --anonymous — Perform this action with an anonymous identity

  • -y, --yes — Run non-interactively wherever possible. This will answer "yes" to almost all prompts, but will sometimes answer "no" to preserve non-interactivity (e.g. when prompting whether to log in with spacetimedb.com).

  • --confirmed <CONFIRMED> — Instruct the server to deliver only updates of confirmed transactions

    Possible values: true, false

  • --no-config — Ignore project configuration when resolving the database target

spacetime env list​

List published environment keys and values

Usage: spacetime env list [OPTIONS] <database>

Arguments:​
  • <DATABASE> — The database name, identity, or configured target
Options:​

  • -s, --server <SERVER> — The nickname, host name or URL of the server

  • --anonymous — Perform this action with an anonymous identity

  • -y, --yes — Run non-interactively wherever possible. This will answer "yes" to almost all prompts, but will sometimes answer "no" to preserve non-interactivity (e.g. when prompting whether to log in with spacetimedb.com).

  • --confirmed <CONFIRMED> — Instruct the server to deliver only updates of confirmed transactions

    Possible values: true, false

  • --no-config — Ignore project configuration when resolving the database target

spacetime delete​

Deletes a SpacetimeDB database

Usage: spacetime delete [OPTIONS] [database]

Run spacetime help delete for more detailed information.

Arguments:​
  • <DATABASE> — The name or identity of the database to delete
Options:​
  • -s, --server <SERVER> — The nickname, host name or URL of the server hosting the database
  • -y, --yes — Run non-interactively wherever possible. This will answer "yes" to almost all prompts, but will sometimes answer "no" to preserve non-interactivity (e.g. when prompting whether to log in with spacetimedb.com).
  • --no-config — Ignore spacetime.json configuration

spacetime logs​

Prints logs from a SpacetimeDB database

Usage: spacetime logs [OPTIONS] [database]

Run spacetime help logs for more detailed information.

Arguments:​
  • <DATABASE> — The name or identity of the database to print logs from
Options:​

  • -s, --server <SERVER> — The nickname, host name or URL of the server hosting the database

  • -n, --num-lines <NUM_LINES> — The number of lines to print from the start of the log of this database. If no num lines is provided, all lines will be returned.

  • -f, --follow — A flag that causes logs to not stop when end of the log file is reached, but rather to wait for additional data to be appended to the input.

  • --format <FORMAT> — Output format for the logs

    Default value: text

    Possible values: text, json

  • -l, --level <LEVEL> — Filter logs by severity level. Only messages at the specified level or higher will be shown. Levels from least to most severe: trace, debug, info, warn, error, panic.

    Possible values: trace, debug, info, warn, error, panic

  • --level-exact — When combined with --level, show only logs at exactly the specified level instead of that level and above.

  • -y, --yes — Run non-interactively wherever possible. This will answer "yes" to almost all prompts, but will sometimes answer "no" to preserve non-interactivity (e.g. when prompting whether to log in with spacetimedb.com).

  • --no-config — Ignore spacetime.json configuration

spacetime call​

Invokes a function (reducer or procedure) in a database. WARNING: This command is UNSTABLE and subject to breaking changes.

Usage: spacetime call [OPTIONS] [call_parts]...

Run spacetime help call for more detailed information.

Arguments:​
  • <CALL_PARTS> — Call arguments: [DATABASE] <FUNCTION_NAME> [ARGUMENTS...]
Options:​
  • -s, --server <SERVER> — The nickname, host name or URL of the server hosting the database
  • --anonymous — Perform this action with an anonymous identity
  • -y, --yes — Run non-interactively wherever possible. This will answer "yes" to almost all prompts, but will sometimes answer "no" to preserve non-interactivity (e.g. when prompting whether to log in with spacetimedb.com).
  • --no-config — Ignore spacetime.json configuration

spacetime describe​

Describe the structure of a database or entities within it. WARNING: This command is UNSTABLE and subject to breaking changes.

Usage: spacetime describe [OPTIONS] [describe_parts]...

Run spacetime help describe for more detailed information.

Arguments:​
  • <DESCRIBE_PARTS> — Describe arguments: [DATABASE] [ENTITY_TYPE [ENTITY_NAME]]. ENTITY_TYPE is one of tables, views, reducers, procedures, routes, env or types. A route is named by its path, and an environment variable by its key.
Options:​

  • --format <FORMAT> — Output format for the schema

    Default value: text

    Possible values: text, json

  • --json — Output the schema in JSON format. Shorthand for --format json.

  • --anonymous — Perform this action with an anonymous identity

  • -s, --server <SERVER> — The nickname, host name or URL of the server hosting the database

  • -y, --yes — Run non-interactively wherever possible. This will answer "yes" to almost all prompts, but will sometimes answer "no" to preserve non-interactivity (e.g. when prompting whether to log in with spacetimedb.com).

  • --no-config — Ignore spacetime.json configuration

spacetime dev​

Start development mode with auto-regenerate client module bindings, auto-rebuild, and auto-publish on file changes.

Usage: spacetime dev [OPTIONS] [database]

Arguments:​
  • <DATABASE> — The database name/identity to publish to (optional, will prompt if not provided)
Options:​

  • --project-path <PROJECT-PATH> — The path to the project directory

    Default value: .

  • --module-bindings-path <MODULE-BINDINGS-PATH> — The path to the module bindings directory relative to the project directory, defaults to <project-path>/src/module_bindings

    Default value: src/module_bindings

  • --module-path <MODULE-PATH> — Path to the SpacetimeDB server module, relative to current directory. Defaults to <project-path>/spacetimedb.

  • --client-lang <CLIENT-LANG> — The programming language for the generated client module bindings (e.g., typescript, csharp, rust, unrealcpp). If not specified, it will be detected from the project.

    Possible values: csharp, typescript, rust, cpp, unrealcpp

  • -s, --server <SERVER> — The nickname, host name or URL of the server to publish to

  • -y, --yes — Run non-interactively wherever possible. This will answer "yes" to almost all prompts, but will sometimes answer "no" to preserve non-interactivity (e.g. when prompting whether to log in with spacetimedb.com).

  • -c, --delete-data <CLEAR-DATABASE> — When publishing to an existing database identity, first DESTROY all data associated with the module. With 'on-conflict': only when breaking schema changes occur.

    Possible values: always, on-conflict, never

  • -t, --template <TEMPLATE> — Template ID or GitHub repository (owner/repo or URL) for project initialization

  • --dotnet-version <VERSION> — Target .NET SDK major version for C# projects (e.g. 8 or 10). Auto-detected when omitted.

  • --native-aot — Build C# projects with NativeAOT-LLVM. Ignored with .NET 10 because NativeAOT-LLVM is always used.

  • --run <COMMAND> — Command to run the client development server (overrides spacetime.json config)

  • --server-only — Only run the server (module) without starting the client

  • --no-config — Ignore spacetime.json configuration

  • --env <ENV> — Environment name for config file layering (e.g., dev, staging). Defaults to 'dev'.

  • --skip-publish — Skip the publish step

  • --skip-generate — Skip the generate step

spacetime sql​

Runs a SQL query on the database. WARNING: This command is UNSTABLE and subject to breaking changes.

Usage: spacetime sql [OPTIONS] [sql_parts]...

Arguments:​
  • <SQL_PARTS> — SQL arguments: [DATABASE] <QUERY>
Options:​

  • --interactive — Instead of using a query, run an interactive command prompt for SQL expressions

  • --confirmed <CONFIRMED> — Instruct the server to deliver only updates of confirmed transactions

    Possible values: true, false

  • --anonymous — Perform this action with an anonymous identity

  • -s, --server <SERVER> — The nickname, host name or URL of the server hosting the database

  • --format <FORMAT> — Output format for the SQL results

    Default value: text

    Possible values: text, json

  • -y, --yes — Run non-interactively wherever possible. This will answer "yes" to almost all prompts, but will sometimes answer "no" to preserve non-interactivity (e.g. when prompting whether to log in with spacetimedb.com).

  • --no-config — Ignore spacetime.json configuration

spacetime mcp​

Serve SpacetimeDB to MCP-aware agents and editors over stdio. WARNING: This command is UNSTABLE and subject to breaking changes.

Usage: spacetime mcp [OPTIONS] [database]

Run spacetime help mcp for more detailed information.

Arguments:​
  • <DATABASE> — The name or identity of a single database to serve. Falls back to the SPACETIMEDB_DB_NAME environment variable. Omit it to serve the whole server, where each tool takes a database argument instead
Options:​
  • -s, --server <SERVER> — The nickname, host name or URL of the server hosting the database
  • --anonymous — Perform this action with an anonymous identity
  • --no-config — Ignore spacetime.json configuration

spacetime rename​

Rename a database

Usage: spacetime rename [OPTIONS] --to <new-name> <database-identity>

Run spacetime rename --help for more detailed information.

Arguments:​
  • <DATABASE-IDENTITY> — The database identity to rename
Options:​
  • --to <NEW-NAME> — The new name you would like to assign
  • -s, --server <SERVER> — The nickname, host name or URL of the server on which to set the name
  • -y, --yes — Run non-interactively wherever possible. This will answer "yes" to almost all prompts, but will sometimes answer "no" to preserve non-interactivity (e.g. when prompting whether to log in with spacetimedb.com).
  • --no-config — Ignore spacetime.json configuration

spacetime generate​

Generate client files for a spacetime module.

Usage: spacetime generate [DATABASE] --lang <LANG> [--module-path <DIR> | --bin-path <PATH> | --js-path <PATH>] [--out-dir <DIR> | --uproject-dir <DIR>] [--unreal-module-name <MODULE_NAME>] [OPTIONS]

Run spacetime help generate for more detailed information.

Arguments:​
  • <DATABASE> — Database name or glob pattern to filter which databases to generate for
Options:​

  • -b, --bin-path <WASM_FILE> — The system path (absolute or relative) to the compiled wasm binary we should inspect

  • -j, --js-path <JS_FILE> — The system path (absolute or relative) to the bundled javascript file we should inspect

  • -p, --module-path <MODULE_PATH> — The system path (absolute or relative) to the module project. Defaults to spacetimedb/ subdirectory, then current directory.

  • -o, --out-dir <OUT_DIR> — The system path (absolute or relative) to the generate output directory

  • --uproject-dir <UPROJECT_DIR> — Path to the Unreal project directory, replaces --out-dir for Unreal generation (only used with --lang unrealcpp)

  • --namespace <NAMESPACE> — The namespace that should be used

    Default value: SpacetimeDB.Types

  • --unreal-module-name <UNREAL_MODULE_NAME> — The module name that should be used for DLL export macros (required for lang unrealcpp)

  • --module-prefix <MODULE_PREFIX> — The module prefix to use for generated types (only used with --lang unrealcpp)

  • --import-extension <IMPORT_EXTENSION> — The extension TypeScript bindings add to their imports of each other: none (the default) for bundlers, js for moduleResolution: "nodenext", ts for runtimes that run TypeScript directly (only used with --lang typescript)

    Possible values: none, js, ts

  • -l, --lang <LANG> — The language to generate

    Possible values: csharp, typescript, rust, cpp, unrealcpp

  • --bindings <BINDINGS> — The kind of bindings to generate (client applications or inter-database module calls)

    Default value: client

    Possible values: client, module

  • --build-options <BUILD_OPTIONS> — Options to pass to the build command, for example --build-options='--lint-dir='

    Default value: ``

  • --dotnet-version <VERSION> — Target .NET SDK major version for C# projects (e.g. 8 or 10). Auto-detected when omitted.

  • --include-private — Include private tables and functions in generated code (types are always included).

    Default value: false

  • -y, --yes — Run non-interactively wherever possible. This will answer "yes" to almost all prompts, but will sometimes answer "no" to preserve non-interactivity (e.g. when prompting whether to log in with spacetimedb.com).

  • --no-config — Ignore spacetime.json configuration

  • --env <ENV> — Environment name for config file layering (e.g., dev, staging)

spacetime list​

Lists the databases attached to an identity. WARNING: This command is UNSTABLE and subject to breaking changes.

Usage: spacetime list [OPTIONS]

Options:​
  • -s, --server <SERVER> — The nickname, host name or URL of the server from which to list databases
  • -y, --yes — Run non-interactively wherever possible. This will answer "yes" to almost all prompts, but will sometimes answer "no" to preserve non-interactivity (e.g. when prompting whether to log in with spacetimedb.com).
  • --no-config — Ignore spacetime.json configuration

spacetime login​

Manage your login to the SpacetimeDB CLI

Usage: spacetime login [OPTIONS] login \<COMMAND\>

Subcommands:​
  • show — Show the current login info
Options:​

  • --auth-host <AUTH-HOST> — Fetch login token from a different host

    Default value: https://spacetimedb.com

  • --token <SPACETIMEDB-TOKEN> — Bypass the login flow and use a login token directly

  • --no-browser — Do not open a browser window

spacetime login show​

Show the current login info

Usage: spacetime login show [OPTIONS]

Options:​
  • --token — Also show the auth token

spacetime logout​

Usage: spacetime logout [OPTIONS]

Options:​

  • --auth-host <AUTH-HOST> — Log out from a custom auth server

    Default value: https://spacetimedb.com

spacetime init​

Initializes a new spacetime project.

Usage: spacetime init [OPTIONS] [PROJECT_NAME]

Arguments:​
  • <PROJECT_NAME> — Project name
Options:​
  • --project-path <PATH> — Directory where the project will be created (defaults to ./<PROJECT_NAME>)
  • --server-only — Initialize server only from the template (no client)
  • --lang <LANG> — Server language: rust, csharp, typescript, cpp (it can only be used when --template is not specified)
  • -t, --template <TEMPLATE> — Template ID or GitHub repository (owner/repo or URL)
  • --local — Use local deployment instead of Maincloud
  • --non-interactive — Run in non-interactive mode
  • --native-aot — Configure C# project for NativeAOT-LLVM compilation (experimental; supported on Windows, and on Linux with .NET 10)
  • --dotnet-version <VERSION> — Target .NET SDK major version for C# projects (e.g. 8 or 10). Defaults to 10 except on macOS or when only .NET 8 is installed.

spacetime build​

Builds a spacetime module.

Usage: spacetime build [OPTIONS]

Options:​

  • -p, --module-path <MODULE_PATH> — The system path (absolute or relative) to the module project. Defaults to spacetimedb/ subdirectory, then current directory.

  • --lint-dir <LINT_DIR> — The directory to lint for nonfunctional print statements. If set to the empty string, skips linting.

    Default value: src

  • -d, --debug — Builds the module using debug instead of release (intended to speed up local iteration, not recommended for CI)

  • --dotnet-version <VERSION> — Target .NET SDK major version for C# projects (e.g. 8 or 10). Auto-detected when omitted.

spacetime server​

Manage the connection to the SpacetimeDB server. WARNING: This command is UNSTABLE and subject to breaking changes.

Usage: spacetime server server \<COMMAND\>

Subcommands:​
  • list — List stored server configurations
  • set-default — Set the default server for future operations
  • add — Add a new server configuration
  • remove — Remove a saved server configuration
  • fingerprint — Show or update a saved server's fingerprint
  • ping — Checks to see if a SpacetimeDB host is online
  • edit — Update a saved server's nickname, host name or protocol
  • clear — Deletes all data from all local databases

spacetime server list​

List stored server configurations

Usage: spacetime server list

spacetime server set-default​

Set the default server for future operations

Usage: spacetime server set-default <server>

Arguments:​
  • <SERVER> — The nickname, host name or URL of the new default server

spacetime server add​

Add a new server configuration

Usage: spacetime server add [OPTIONS] --url <url> <name>

Arguments:​
  • <NAME> — Nickname for this server
Options:​
  • --url <URL> — The URL of the server to add
  • -d, --default — Make the new server the default server for future operations
  • --no-fingerprint — Skip fingerprinting the server

spacetime server remove​

Remove a saved server configuration

Usage: spacetime server remove [OPTIONS] <server>

Arguments:​
  • <SERVER> — The nickname, host name or URL of the server to remove
Options:​
  • -y, --yes — Run non-interactively wherever possible. This will answer "yes" to almost all prompts, but will sometimes answer "no" to preserve non-interactivity (e.g. when prompting whether to log in with spacetimedb.com).

spacetime server fingerprint​

Show or update a saved server's fingerprint

Usage: spacetime server fingerprint [OPTIONS] <server>

Arguments:​
  • <SERVER> — The nickname, host name or URL of the server
Options:​
  • -y, --yes — Run non-interactively wherever possible. This will answer "yes" to almost all prompts, but will sometimes answer "no" to preserve non-interactivity (e.g. when prompting whether to log in with spacetimedb.com).

spacetime server ping​

Checks to see if a SpacetimeDB host is online

Usage: spacetime server ping <server>

Arguments:​
  • <SERVER> — The nickname, host name or URL of the server to ping

spacetime server edit​

Update a saved server's nickname, host name or protocol

Usage: spacetime server edit [OPTIONS] <server>

Arguments:​
  • <SERVER> — The nickname, host name or URL of the server
Options:​
  • --new-name <NICKNAME> — A new nickname to assign the server configuration
  • --url <URL> — A new URL to assign the server configuration
  • --no-fingerprint — Skip fingerprinting the server
  • -y, --yes — Run non-interactively wherever possible. This will answer "yes" to almost all prompts, but will sometimes answer "no" to preserve non-interactivity (e.g. when prompting whether to log in with spacetimedb.com).

spacetime server clear​

Deletes all data from all local databases

Usage: spacetime server clear [OPTIONS]

Options:​
  • --data-dir <DATA_DIR> — The path to the server data directory to clear [default: that of the selected spacetime instance]
  • -y, --yes — Run non-interactively wherever possible. This will answer "yes" to almost all prompts, but will sometimes answer "no" to preserve non-interactivity (e.g. when prompting whether to log in with spacetimedb.com).

spacetime subscribe​

Subscribe to SQL queries on the database. WARNING: This command is UNSTABLE and subject to breaking changes.

Usage: spacetime subscribe [OPTIONS] [subscribe_parts]...

Arguments:​
  • <SUBSCRIBE_PARTS> — Subscribe arguments: [DATABASE] <QUERY> [QUERY...]
Options:​

  • -n, --num-updates <NUM-UPDATES> — The number of subscription updates to receive before exiting

  • -t, --timeout <TIMEOUT> — The timeout, in seconds, after which to disconnect and stop receiving subscription messages. If -n is specified, it will stop after whichever one comes first. Timing out before receiving -n updates is an error.

  • --print-initial-update — Print the initial update for the queries.

  • --confirmed <CONFIRMED> — Instruct the server to deliver only updates of confirmed transactions

    Possible values: true, false

  • --anonymous — Perform this action with an anonymous identity

  • -y, --yes — Run non-interactively wherever possible. This will answer "yes" to almost all prompts, but will sometimes answer "no" to preserve non-interactivity (e.g. when prompting whether to log in with spacetimedb.com).

  • --no-config — Ignore spacetime.json configuration

  • -s, --server <SERVER> — The nickname, host name or URL of the server hosting the database

spacetime start​

Start a local SpacetimeDB instance

Set a persistent default listen address in cli.toml with: listen_addr = "0.0.0.0:4000"

When present, listen_addr is used unless --listen-addr is passed explicitly.

Run spacetime start --help to see all options.

Usage: spacetime start [OPTIONS] [args]...

Arguments:​
  • <ARGS> — The args to pass to spacetimedb-{edition} start
Options:​

  • --edition <EDITION> — The edition of SpacetimeDB to start up

    Default value: standalone

    Possible values: standalone, cloud

spacetime lock​

Lock a database to prevent it from being deleted.

A locked database cannot be deleted until it is unlocked with spacetime unlock. This is a safety mechanism to protect production databases from accidental deletion.

Usage: spacetime lock [OPTIONS] [database]

Run spacetime help lock for more detailed information.

Arguments:​
  • <DATABASE> — The name or identity of the database to lock
Options:​
  • -s, --server <SERVER> — The nickname, host name or URL of the server hosting the database
  • --no-config — Ignore spacetime.json configuration

spacetime unlock​

Unlock a database that was previously locked with spacetime lock.

After unlocking, the database can be deleted normally with spacetime delete.

Usage: spacetime unlock [OPTIONS] [database]

Run spacetime help unlock for more detailed information.

Arguments:​
  • <DATABASE> — The name or identity of the database to unlock
Options:​
  • -s, --server <SERVER> — The nickname, host name or URL of the server hosting the database
  • --no-config — Ignore spacetime.json configuration

spacetime auth​

Manage SpacetimeAuth for a database

Usage: spacetime auth <COMMAND>

Subcommands:​
  • config — Manage SpacetimeAuth configuration for a database
  • idp — Manage identity providers for a database
  • client — Manage OAuth clients for a database

spacetime auth config​

Manage SpacetimeAuth configuration for a database

Usage: spacetime auth config <COMMAND>

Subcommands:​
  • set — Set a SpacetimeAuth configuration value for a database
  • reset — Reset the SpacetimeAuth configuration of a database to its defaults, keeping the display name and Steam settings

spacetime auth config set​

Set a SpacetimeAuth configuration value for a database

Usage: spacetime auth config set <database> <key> <value>

Arguments:​

  • <DATABASE> — The name of the database (not its identity)

  • <KEY> — The setting to configure

    Possible values: display_name, favicon_url, color.text, color.background, color.primary, color.input, color.border, login.email, login.anonymous, steam.publisher_key, steam.app_ids

  • <VALUE> — The value to assign to the setting. steam.app_ids takes a comma-separated list; an empty value clears a Steam setting

spacetime auth config reset​

Reset the SpacetimeAuth configuration of a database to its defaults, keeping the display name and Steam settings

Usage: spacetime auth config reset <database>

Arguments:​
  • <DATABASE> — The name of the database (not its identity)

spacetime auth idp​

Manage identity providers for a database

Usage: spacetime auth idp <COMMAND>

Subcommands:​
  • set — Configure and enable an identity provider for a database
  • enable — Enable an identity provider for a database
  • disable — Disable an identity provider for a database

spacetime auth idp set​

Configure and enable an identity provider for a database

Usage: spacetime auth idp set <database> <idp> <client_id> [client_secret]

Arguments:​

  • <DATABASE> — The name of the database (not its identity)

  • <IDP> — The identity provider to configure

    Possible values: google, twitch, discord, kick, github, trackmania

  • <CLIENT_ID> — The OAuth client ID

  • <CLIENT_SECRET> — The OAuth client secret. If omitted, it is prompted for, or read from stdin when piped

spacetime auth idp enable​

Enable an identity provider for a database

Usage: spacetime auth idp enable <database> <idp>

Arguments:​

  • <DATABASE> — The name of the database (not its identity)

  • <IDP> — The identity provider to configure

    Possible values: google, twitch, discord, kick, github, trackmania

spacetime auth idp disable​

Disable an identity provider for a database

Usage: spacetime auth idp disable <database> <idp>

Arguments:​

  • <DATABASE> — The name of the database (not its identity)

  • <IDP> — The identity provider to configure

    Possible values: google, twitch, discord, kick, github, trackmania

spacetime auth client​

Manage OAuth clients for a database

Usage: spacetime auth client <COMMAND>

Subcommands:​
  • create — Create a new OAuth client
  • delete — Delete an OAuth client
  • get — Get an OAuth client
  • set — Set a configuration value for an OAuth client

spacetime auth client create​

Create a new OAuth client

Usage: spacetime auth client create [OPTIONS] <database>

Arguments:​
  • <DATABASE> — The name of the database (not its identity)
Options:​

  • --name <NAME> — The client name

    Default value: Default Client

  • --private — Create the client as private (requires a client secret for token exchange)

spacetime auth client delete​

Delete an OAuth client

Usage: spacetime auth client delete [OPTIONS] <database>

Arguments:​
  • <DATABASE> — The name of the database (not its identity)
Options:​

  • --name <NAME> — The client name

    Default value: Default Client

spacetime auth client get​

Get an OAuth client

Usage: spacetime auth client get [OPTIONS] <database>

Arguments:​
  • <DATABASE> — The name of the database (not its identity)
Options:​

  • --name <NAME> — The client name

    Default value: Default Client

  • --include-secret — Include the client secret in the output

spacetime auth client set​

Set a configuration value for an OAuth client

Usage: spacetime auth client set [OPTIONS] <database> <key> <value>

Arguments:​

  • <DATABASE> — The name of the database (not its identity)

  • <KEY> — The setting to configure

    Possible values: name, private, web, native, redirect_uris, post_logout_redirect_uris

  • <VALUE> — The value to assign to the setting. URI lists are comma-separated; an empty value clears the list

Options:​

  • --name <NAME> — The client name

    Default value: Default Client

spacetime version​

Manage installed spacetime versions

Run spacetime version --help to see all options.

Usage: spacetime version [ARGS]...

Arguments:​
  • <ARGS> — The args to pass to spacetimedb-update

This document was generated automatically by clap-markdown.