SKILL.md
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):
railway domain --jsonFor a specific service:
railway domain --json --service backendResponse
Returns the generated domain URL. Service must have a deployment.
Add Custom Domain
railway domain example.com --jsonResponse
Returns required DNS records:
{
"domain": "example.com",
"dnsRecords": [
{ "type": "CNAME", "host": "@", "value": "..." }
]
}Tell user to add these records to their DNS provider.
Read Current Domains
Use environment skill to see configured domains, or query directly:
query domains($envId: String!) {
environment(id: $envId) {
config(decryptVariables: false)
}
}Domains are in config.services.<serviceId>.networking:
serviceDomains- Railway-provided domains
customDomains- User-provided domains
Remove Domain
Use environment skill to remove domains:
Remove custom domain
{
"services": {
"<serviceId>": {
"networking": {
"customDomains": { "<domainId>": null }
}
}
}
}Remove railway domain
{
"services": {
"<serviceId>": {
"networking": {
"serviceDomains": { "<domainId>": null }
}
}
}
}Then use environment skill to apply and commit the change.
CLI Options
Flag
Description
[DOMAIN]
Custom domain to add (omit for railway domain)
-p, --port <PORT>
Port to connect
-s, --service <NAME>
Target service (defaults to linked)
--json
JSON output
Composability
- Read domains: Use
environmentskill
- Remove domains: Use
environmentskill
- Apply removal: Use
environmentskill
- Check service: Use
serviceskill
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".