Create and Clone Repositories

How to create repositories through the web UI or CLI, clone them locally, and configure remotes.

Create a repository

Using the web UI

Sign in at outpost.run .
Click the + button in the top navigation and select New Repository.
Configure settings:
- Owner — your personal account or a team namespace.
- Repository name — lowercase with hyphens (e.g., imagenet-preprocessing).
- Visibility — Public (visible to everyone) or Private (visible only to collaborators).
Optionally initialize with a README and LICENSE.
Click Create Repository.

Using the CLI

Create a repository directly from the command line:

# Create a public repository
outpost create-remote --name my-namespace/my-dataset -p
 
# Create a private repository under a team
outpost create-remote --name my-team/training-data

# Create a public repository
outpost create-remote --name my-namespace/my-dataset -p
 
# Create a private repository under a team
outpost create-remote --name my-team/training-data

Flags:

--name / -n — namespace/repo-name (required)
-p — make the repository public
--host — target host (default: outpost.run)
--add_readme — create a README and initial commit

Clone a repository

Cloning downloads the repository to your local machine.

Clone over HTTPS

outpost clone https://outpost.run/my-namespace/my-repo

You will be prompted for your Outpost username and access token on first clone.

Clone over SSH

If you have added an SSH key to your Outpost account:

outpost clone [email protected]:my-namespace/my-repo.git

Tip

SSH cloning avoids repeated credential prompts. See [SSH Keys](/docs/teams/ssh-keys) to set up key-based authentication.

Partial and shallow clones

For large repositories, you can filter what gets downloaded:

# Clone only the latest commit
outpost clone --depth 1 https://outpost.run/my-namespace/my-repo
 
# Clone only a specific directory
outpost clone --filter path/to/dir https://outpost.run/my-namespace/my-repo
 
# Clone a specific branch
outpost clone --branch experiment-v2 https://outpost.run/my-namespace/my-repo

# Clone only the latest commit
outpost clone --depth 1 https://outpost.run/my-namespace/my-repo
 
# Clone only a specific directory
outpost clone --filter path/to/dir https://outpost.run/my-namespace/my-repo
 
# Clone a specific branch
outpost clone --branch experiment-v2 https://outpost.run/my-namespace/my-repo

Clone in remote mode

For very large repositories where you only need metadata locally:

outpost clone --remote https://outpost.run/my-namespace/my-repo

This clones metadata only — file contents are fetched on demand.

Configure remotes

After cloning, your repository has a default remote named origin. You can manage remotes with the outpost config command:

# View current remote configuration
outpost remote -v
 
# Set or update a remote
outpost config --set-remote origin https://outpost.run/my-namespace/my-repo
 
# Delete a remote
outpost config --delete-remote upstream

# View current remote configuration
outpost remote -v
 
# Set or update a remote
outpost config --set-remote origin https://outpost.run/my-namespace/my-repo
 
# Delete a remote
outpost config --delete-remote upstream

Next steps

Previous → Overview

Next Branching & Merging →