A space is the owned container TinyCloud uses for data and permissions. Use this page when you need to host a new owned space, inspect the current one, or switch the active space name.
Host a space
create and host are aliases. They host one of your owned spaces by name and return the resolved space URI.
Inspect a space
tc space info accepts either the active space or a specific space URI/name. Use tc space list first if you want to see what is already hosted.
Switch the active space name
Switching changes the default space name stored in the profile. It does not create or host the space by itself.
Delegate-only hosting
If you are not the owner of a space, use tc space host-request <name> to emit a host request artifact for the owner.
When to use spaces
- Host the
applications space before writing manifest-scoped app data
- Host the
secrets space when a session needs TinyCloud secrets access
- Switch the active space name when you want the CLI to target a different owned space by default
tc kv, tc sql, and tc secrets all use the active profile and may target a non-primary space with --space when needed.
