Custom Domains

With custom domains, your applications can use professional URLs (like app.yourcompany.com) instead of auto-assigned test domains.

Setup Steps

1. Get a Domain

If you don’t have a domain yet, you can purchase one from providers such as:

• Namecheap
• Cloudflare Registrar
• Google Domains
• GoDaddy
• Gandi

2. Configure DNS Records

In your DNS provider’s control panel, add records pointing to your VPS IP:

Root Domain (example.com)

Type:  A
Name:  @
Value: 123.456.789.0  (your VPS IP)
TTL:   3600

Subdomain (app.example.com)

Type:  A
Name:  app
Value: 123.456.789.0  (your VPS IP)
TTL:   3600

WWW Domain

Type:  CNAME
Name:  www
Value: example.com
TTL:   3600

3. Configure the Domain in Piora

1. Go to the application settings page
2. Click the “Domains” section
3. Enter your domain (e.g., app.example.com)
4. Click “Add”

Piora will automatically:

• Create routing rules in Traefik
• Request a Let’s Encrypt SSL certificate
• Set up HTTP to HTTPS redirection

DNS Verification

When adding a domain, Piora checks if DNS records correctly point to your server. If DNS hasn’t propagated yet, you can try again later.

Multiple Domain Support

Each application can have multiple domains configured, for example:

• example.com (root domain)
• www.example.com (www subdomain)
• app.example.com (app subdomain)

All domains point to the same application, each with its own SSL certificate.

Using Cloudflare

If you use Cloudflare to manage DNS:

Recommended Setup

1. Set Cloudflare’s Proxy status to “DNS Only” (gray cloud)
2. Let Piora’s Traefik handle SSL directly

Avoid Double Proxying

If Cloudflare’s proxy is enabled (orange cloud), SSL settings may conflict. We recommend starting with “DNS Only” mode. If you need Cloudflare’s proxy, set the SSL mode to “Full (Strict)”.

Cloudflare + Piora SSL Modes

Cloudflare SSL Mode	Description	Recommendation
Off	No SSL	Not recommended
Flexible	Cloudflare to server uses HTTP	Not recommended
Full	Allows self-signed certificates	Acceptable
Full (Strict)	Requires valid certificates	Recommended

Wildcard Domains

If you need to route multiple subdomains to different applications:

Type:  A
Name:  *
Value: 123.456.789.0

Then configure the corresponding subdomain in each application.

Troubleshooting

Domain Not Accessible

1. Verify DNS records have propagated: dig app.example.com or use an online DNS checker
2. Confirm ports 80 and 443 are open on your VPS
3. Confirm Traefik is running normally

SSL Certificate Request Failed

1. DNS must correctly point to your VPS IP
2. Port 80 must be open (required for Let’s Encrypt HTTP-01 validation)
3. Ensure the domain isn’t already used by another SSL configuration

# Check DNS resolution
dig +short app.example.com
# Should return your VPS IP

# Test port
curl -I http://app.example.com