Changing a Domain Name

If you need to change the domain name of an existing instance, follow these steps to securely swap out the domain and generate a new SSL certificate.

Step 1: Point your new domain to the server

Before you change anything in the dashboard, ensure your new domain's DNS is properly configured.

  1. Go to your DNS provider.
  2. Create an A Record for the new domain pointing to your server's public IP address.
  3. Wait for the DNS to propagate (usually a few minutes).

Step 2: Update the domain in the Servers tab

Once DNS is ready, you need to detach the old domain and attach the new one at the server level.

  1. Navigate to the Servers tab.
  2. Locate your server and disconnect the old domain.
  3. Add the new domain name in that same section.
  4. Use the built-in DNS check to confirm the new domain is resolving properly to the server.

Step 3: Re-apply SSL in the Instances tab

The final step is to tell the agent to update the web server configuration and fetch a new certificate.

  1. Navigate to the Instances tab.
  2. Click on your specific n8n instance.
  3. Locate the SSL settings and click on Re-apply SSL.
The agent will automatically request a new Let's Encrypt certificate for your new domain and update the Caddy configuration. Your instance will seamlessly switch over to the new domain.