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

# Multi-Repo Workspaces

> Work with multiple repositories inside a single sandbox environment.

## Overview

Sandboxes do not clone repositories at startup. Multi-repo workflows are handled inside the running sandbox using the browser IDE or terminal.

## Recommended Flow

```bash theme={null} theme={null}
cd /root/workspace
gh auth login
git clone https://github.com/acme/frontend
git clone https://github.com/acme/api
git clone https://github.com/acme/shared-lib
```

All repos live under `/root/workspace`, which is stored on a persistent [volumeset](/reference/volumeset). The workspace survives suspend/resume and is removed when the environment is deleted.

## Private Repos

Use provider-native tooling inside the environment:

* **GitHub:** `gh auth login`
* **GitLab:** `glab auth login` (if installed in the toolbox)
* **SSH:** add keys under `/root/.ssh`

Credentials stored under `/root` persist with the environment.

## Running Multiple Services

Start services from separate IDE terminals. The configured app port is served at the workload root URL. Additional local ports can be reached through the `/_port/<N>/` gateway route.

<Tip>
  Use `sandbox ports` to see all detected ports with their external URLs. Bind dev servers to `0.0.0.0` so the gateway can reach them.
</Tip>