Skip to main content
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.