How it works
1
Choose your source
Connect a GitHub repo, push local code, or provide a Docker image. Source builds use your Dockerfile or detect your framework automatically.
2
Configure your app
Set environment variables and add databases. Your app must listen on port 8080. A health check path that returns HTTP 200 is optional but recommended.
3
Deploy and share
Locus builds and starts your services. Once health checks pass, share the service URL or connect a domain.
Deploy with your agent
Send your agent the Build skill with a request like:Deploy this repository with Build with Locus. Add Postgres, configure the app’s database connection, and send me the live URL when it’s healthy.Your agent sets up the project, configures services, and follows the deployment. Getting started covers credentials and your first deploy.
What you get
- Three deploy sources: GitHub with automatic deploys,
git pushfrom a local repo, or a pre-built Docker image. - Managed databases: Postgres or Redis, connected through environment variables.
- Public URLs and SSL: a generated service URL, or your own domain.
- Separate environments: development, staging, and production in one project.
- Deployment controls: read logs, cancel a deployment, restart a service, or roll back.
Key concepts
Pricing
Services and addons each cost $1.50/month, or $0.25/month for workspaces that pay with x402 on Polygon. Charges come from workspace credits. See pricing and credits.Next steps
Getting started
Connect your account and deploy your first service.
Services
Choose a source and configure a service.
Variables and connections
Connect services and databases.
Addons
Add Postgres or Redis.