Skip to main content
Addons are managed infrastructure resources provisioned into your environment. Custom domains give your services a public URL with SSL.

​
Available addons

Postgres

Managed PostgreSQL database. Locus creates a dedicated database and user in a managed database instance. Connection string auto-injected as DATABASE_URL.

Redis

Managed Redis cache. Locus allocates a dedicated database number in a managed cache cluster. Connection string auto-injected as REDIS_URL.

​
How addons work

1

Provision

Create an addon in your environment from the dashboard or API. Specify the type (Postgres or Redis) and a name.
2

Wait for provisioning

Locus creates the underlying infrastructure. This typically takes 30-60 seconds for Postgres and 10-20 seconds for Redis.
3

Wire to your service

Add the addon’s connection variable to your service using template syntax (e.g., "DATABASE_URL": "${{db.DATABASE_URL}}"). See Variables & Wiring for the full template reference.
4

Redeploy

Trigger a new deployment on your service to pick up the injected variables. The container will have DATABASE_URL or REDIS_URL set as environment variables.

​
Addon lifecycle

​
Injected variables

These variables appear alongside your service and environment variables. Service-level variables take priority if there’s a naming conflict.

​
Custom domains

Bring Your Own Domain

Use a domain you already own. Add DNS records pointing to Locus and verify ownership. Works with any DNS provider.

Purchase a Domain

Buy a new domain directly through Locus. DNS, SSL, and routing are auto-configured — no manual steps.

​
Bring your own domain

Use a domain you already own. You’ll add DNS records and verify ownership before attaching it to a service.
1

Register your domain

Add your domain from the dashboard. Locus requests an SSL certificate and provides a CNAME target and certificate validation records.
2

Add DNS records

At your DNS provider, add two records:
  1. Certificate validation CNAME — proves domain ownership for SSL certificate issuance
  2. Domain CNAME — points your domain at the Locus load balancer
3

Verify

Once DNS records propagate (typically 1-30 minutes), verify the domain from the dashboard. Both the CNAME and SSL certificate must validate before the domain can be attached.
4

Attach to a service

Attach the verified domain to any service in the project. Traffic to your domain routes to the attached service with SSL.

​
Purchase a domain

Buy a new domain through Locus. DNS, SSL, and routing are handled automatically.
1

Search for a domain

Search for available domains from the dashboard. Locus shows availability and pricing across popular TLDs.
2

Purchase

Complete the purchase with contact information. Registration is asynchronous and typically takes 1-15 minutes.
3

Automatic configuration

Once registered, Locus automatically creates DNS records, requests and validates an SSL certificate, and adds it to the load balancer.
4

Attach to a service

Attach the domain to any service in the project. Your service is now live at the purchased domain.