> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tinycloud.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Spaces

> Host, inspect, and switch TinyCloud spaces

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

```bash theme={null}
tc space create applications
tc space host applications
```

`create` and `host` are aliases. They host one of your owned spaces by name and return the resolved space URI.

## Inspect a space

```bash theme={null}
tc space list
tc space info
tc space info applications
```

`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

```bash theme={null}
tc space switch applications
```

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

<Tip>
  `tc kv`, `tc sql`, and `tc secrets` all use the active profile and may target a non-primary space with `--space` when needed.
</Tip>
