Railway Domain Management

Add, view, or remove domains for Railway services.

When to Use

• User asks to “add a domain”, “generate a domain”, “get a URL”
• User wants to add a custom domain
• User asks “what’s the URL for my service”
• User wants to remove a domain

Add Railway Domain

Generate a railway-provided domain (max 1 per service):

1railway domain --json

For a specific service:

1railway domain --json --service backend

Response

Returns the generated domain URL. Service must have a deployment.

Add Custom Domain

1railway domain example.com --json

Response

Returns required DNS records:

1{
2  "domain": "example.com",
3  "dnsRecords": [
4    { "type": "CNAME", "host": "@", "value": "..." }
5  ]
6}

Tell user to add these records to their DNS provider.

Read Current Domains

Use railway-environment skill to see configured domains, or query directly:

1query domains($envId: String!) {
2  environment(id: $envId) {
3    config(decryptVariables: false)
4  }
5}

Domains are in config.services.<serviceId>.networking:

• serviceDomains - Railway-provided domains
• customDomains - User-provided domains

Remove Domain

Use railway-environment skill to remove domains:

Remove custom domain

1{
2  "services": {
3    "<serviceId>": {
4      "networking": {
5        "customDomains": { "<domainId>": null }
6      }
7    }
8  }
9}

Remove railway domain

1{
2  "services": {
3    "<serviceId>": {
4      "networking": {
5        "serviceDomains": { "<domainId>": null }
6      }
7    }
8  }
9}

Then use railway-environment skill to apply and commit the change.

CLI Options

Composability

• Read domains: Use railway-environment skill
• Remove domains: Use railway-environment skill
• Apply removal: Use railway-environment skill
• Check service: Use railway-service skill

Error Handling

No Service Linked

No service linked. Use --service flag or run `railway service` to select one.

Domain Already Exists

Service already has a railway-provided domain. Maximum 1 per service.

No Deployment

Service has no deployment. Deploy first with `railway up`.

Invalid Domain

Invalid domain format. Use a valid domain like "example.com" or "api.example.com".