# Freestyle Docs

Documentation for Freestyle VMs and Freestyle Git.

## Pages

- [Freestyle](/docs): Infrastructure for code your product runs but didn't write.
- [Quickstart](/docs/quickstart): Install Freestyle and create your first VM.
- [Freestyle VMs](/docs/vms): Create and control fast Linux virtual machines for agent workspaces and user sessions.
- [VM Lifecycle](/docs/vms/lifecycle): Understand the VM states Freestyle exposes: running, stopped, forked, and deleted.
- [SSH Access](/docs/vms/ssh): SSH into Freestyle VMs with scoped identity tokens.
- [Client Sessions](/docs/vms/client-sessions): Let browser clients operate existing Freestyle VMs with scoped access tokens.
- [VM Domains](/docs/vms/domains): Route HTTPS traffic from custom domains to services running inside Freestyle VMs.
- [Domain Verification](/docs/vms/domain-verification): Verify that you own a custom domain before routing it to a Freestyle VM.
- [Domain DNS](/docs/vms/domain-dns): Configure DNS records for custom domains that route to Freestyle VMs.
- [Domain Mappings](/docs/vms/domain-mappings): Create, list, and delete mappings from custom domains to VM ports.
- [Domains CLI](/docs/vms/domains-cli): Use the Freestyle CLI to verify domains and map them to VM ports.
- [VPCs](/docs/vms/network/vpcs): Create private networks for Freestyle VMs and attach VM network interfaces to them.
- [VPNs](/docs/vms/network/vpns): Use WireGuard to connect your computer to a Freestyle VPC.
- [PTY Sessions](/docs/vms/pty): Open persistent interactive shells on a VM that survive WebSocket disconnects, VM suspends, and forks.
- [Freestyle Git](/docs/git): Create and manage multi-tenant Git repositories for user- and agent-generated code.
- [Repositories](/docs/git/repositories): Create, list, delete, and authenticate Freestyle Git repositories.
- [Git API](/docs/git/api): Read and modify repository data through Freestyle Git APIs.
- [Search](/docs/git/search): Search repository contents, filenames, commit messages, and diffs.
- [Triggers](/docs/git/triggers): Send webhooks when Freestyle Git repositories receive pushes.
- [GitHub Sync](/docs/git/github-sync): Synchronize Freestyle Git repositories with GitHub repositories.
- [Freestyle CLI](/docs/cli): Install and use the Freestyle CLI for local VM and Git workflows.
- [VM CLI](/docs/vms/cli): Use the Freestyle CLI for quick VM operations and debugging.
- [Git CLI](/docs/git/cli): Use Freestyle CLI commands for Git repository lifecycle operations.

## Markdown

- [Freestyle](/docs/index.md)
- [Quickstart](/docs/quickstart.md)
- [Freestyle VMs](/docs/vms.md)
- [VM Lifecycle](/docs/vms/lifecycle.md)
- [SSH Access](/docs/vms/ssh.md)
- [Client Sessions](/docs/vms/client-sessions.md)
- [VM Domains](/docs/vms/domains.md)
- [Domain Verification](/docs/vms/domain-verification.md)
- [Domain DNS](/docs/vms/domain-dns.md)
- [Domain Mappings](/docs/vms/domain-mappings.md)
- [Domains CLI](/docs/vms/domains-cli.md)
- [VPCs](/docs/vms/network/vpcs.md)
- [VPNs](/docs/vms/network/vpns.md)
- [PTY Sessions](/docs/vms/pty.md)
- [Freestyle Git](/docs/git.md)
- [Repositories](/docs/git/repositories.md)
- [Git API](/docs/git/api.md)
- [Search](/docs/git/search.md)
- [Triggers](/docs/git/triggers.md)
- [GitHub Sync](/docs/git/github-sync.md)
- [Freestyle CLI](/docs/cli.md)
- [VM CLI](/docs/vms/cli.md)
- [Git CLI](/docs/git/cli.md)