# Portless

## Docs

- [Introduction](https://mintlify.wiki/vercel-labs/portless/introduction.md): Replace port numbers with stable, named .localhost URLs for local development
- [Quickstart](https://mintlify.wiki/vercel-labs/portless/quickstart.md): Get started with Portless in under 2 minutes
- [Why Portless?](https://mintlify.wiki/vercel-labs/portless/why.md): Understand the problems Portless solves and when to use it
- [How It Works](https://mintlify.wiki/vercel-labs/portless/how-it-works.md): Understanding Portless proxy architecture, route registration, and port assignment
- [Git Worktrees](https://mintlify.wiki/vercel-labs/portless/git-worktrees.md): Automatic branch-based subdomain prefixing for git worktrees
- [Subdomains](https://mintlify.wiki/vercel-labs/portless/subdomains.md): Organizing services with subdomains and wildcard routing
- [HTTPS & HTTP/2](https://mintlify.wiki/vercel-labs/portless/https.md): Enable HTTP/2 + HTTPS for faster dev server page loads with automatic certificate generation
- [Wildcard Routing](https://mintlify.wiki/vercel-labs/portless/wildcard-routing.md): Route any subdomain to a registered app without additional configuration
- [Static Routes](https://mintlify.wiki/vercel-labs/portless/static-routes.md): Register persistent routes for services running outside portless control
- [Environment Variables](https://mintlify.wiki/vercel-labs/portless/environment-variables.md): Configure Portless behavior using environment variables
- [State Directory](https://mintlify.wiki/vercel-labs/portless/state-directory.md): Understanding Portless state management and directory structure
- [Safari DNS Issues](https://mintlify.wiki/vercel-labs/portless/safari-dns.md): How to fix .localhost subdomain resolution in Safari
- [Proxying Between Apps](https://mintlify.wiki/vercel-labs/portless/proxying-between-apps.md): How to proxy requests between portless apps without triggering loop detection
- [Framework Support](https://mintlify.wiki/vercel-labs/portless/framework-support.md): Which frameworks work automatically with portless and which need flag injection
- [portless run](https://mintlify.wiki/vercel-labs/portless/commands/run.md): Infer project name and run through the proxy
- [portless <name>](https://mintlify.wiki/vercel-labs/portless/commands/app.md): Run an app with an explicit name
- [portless alias](https://mintlify.wiki/vercel-labs/portless/commands/alias.md): Register static routes for external services
- [portless list](https://mintlify.wiki/vercel-labs/portless/commands/list.md): Show all active routes
- [portless get](https://mintlify.wiki/vercel-labs/portless/commands/get.md): Print the URL for a service without running it
- [portless trust](https://mintlify.wiki/vercel-labs/portless/commands/trust.md): Add local CA to system trust store
- [portless hosts](https://mintlify.wiki/vercel-labs/portless/commands/hosts.md): Manage /etc/hosts entries for Safari
- [portless proxy](https://mintlify.wiki/vercel-labs/portless/commands/proxy.md): Manage the proxy server
- [CLI Flags](https://mintlify.wiki/vercel-labs/portless/commands/flags.md): Complete reference for all CLI flags
- [Environment Variables](https://mintlify.wiki/vercel-labs/portless/commands/environment.md): Configuration via environment variables
- [Programmatic API](https://mintlify.wiki/vercel-labs/portless/api/overview.md): Use Portless as a library in your Node.js applications
- [createProxyServer](https://mintlify.wiki/vercel-labs/portless/api/proxy.md): Create an HTTP/HTTPS proxy server with hostname-based routing
- [RouteStore](https://mintlify.wiki/vercel-labs/portless/api/routes.md): Manage route mappings with file-based persistence and locking
- [Type Definitions](https://mintlify.wiki/vercel-labs/portless/api/types.md): TypeScript interfaces and types exported by Portless
- [Utility Functions](https://mintlify.wiki/vercel-labs/portless/api/utilities.md): Helper functions for hostname parsing, file management, and /etc/hosts manipulation
- [Troubleshooting](https://mintlify.wiki/vercel-labs/portless/troubleshooting.md): Common issues and solutions for Portless CLI
- [Changelog](https://mintlify.wiki/vercel-labs/portless/changelog.md): Release history and version updates for Portless CLI
- [Contributing](https://mintlify.wiki/vercel-labs/portless/contributing.md): Guidelines for contributing to Portless CLI development