how to use custom domains in bonsai

3 min read 21-01-2025

Meta Description: Learn how to connect your custom domain to your Bonsai website for a professional and branded online presence. This guide provides a step-by-step walkthrough, covering DNS record configuration and troubleshooting tips. Boost your credibility and streamline your online identity today!

Introduction: Why Use a Custom Domain with Bonsai?

Using a custom domain with your Bonsai website is crucial for building a professional online presence. Instead of using the default bonsai.io address, a custom domain (like yourname.com or yourbusiness.com) instantly enhances credibility and brand recognition. It makes your website look more polished and trustworthy. This guide will walk you through the simple process of connecting your custom domain to Bonsai.

Before You Begin: Preparations

Before starting, you'll need a few things:

A registered domain name: Purchase your domain from a registrar like Google Domains, Namecheap, or GoDaddy.
Your Bonsai website: Ensure your Bonsai site is up and running.
Access to your domain registrar's DNS settings: You'll need the ability to modify your domain's DNS records.

Step-by-Step Guide: Connecting Your Custom Domain

Here's a detailed, step-by-step process:

1. Accessing Bonsai Settings

Log in to your Bonsai account. Navigate to the settings for your specific Bonsai site. The exact location of these settings may vary slightly depending on your Bonsai version, but generally, it will be under a "Settings," "Domains," or "Custom Domain" tab.

2. Finding Your Bonsai Subdomain

Bonsai will provide you with a subdomain (e.g., your-site-name.bonsai.io). You'll need this subdomain in the next step.

3. Configuring DNS Records at Your Domain Registrar

This is the most important step. You need to modify your domain's DNS records at your registrar's website. You'll typically need to add the following records:

A Record: This record maps your custom domain to Bonsai's IP address. Bonsai usually provides this IP address within its custom domain settings. You might see multiple IP addresses listed; add all of them as separate A records. For example:
- Name/Host: @ or your domain name (e.g., www)
- Type: A
- Value/Points to: Bonsai's IP address(es)
- TTL: A lower TTL (e.g., 300 seconds) will propagate changes faster, but isn't strictly necessary.
CNAME Record (Optional but Recommended): A CNAME record creates an alias for your www subdomain, pointing it to your root domain. This simplifies management and ensures consistency. For example:
- Name/Host: www
- Type: CNAME
- Value/Points to: your-site-name.bonsai.io (or the Bonsai subdomain provided)
- TTL: 300 seconds
Possible Additional Records: Bonsai may require additional records, such as TXT records for verification. Follow Bonsai's specific instructions carefully.

Important Note: The specific terminology and interface for managing DNS records may differ depending on your domain registrar (Namecheap, GoDaddy, Google Domains, etc.). Consult your registrar's help documentation if needed.

4. Propagation Time

After adding these DNS records, it takes time for the changes to propagate across the internet (DNS propagation). This can take anywhere from a few minutes to a few hours.

5. Verification in Bonsai

Once you've added the DNS records, return to your Bonsai settings. Bonsai usually has a verification process to confirm that your DNS records are correctly configured. This might involve checking for a specific TXT record or simply waiting for the domain to verify automatically.

6. Enjoy Your Custom Domain!

Once Bonsai verifies your custom domain, your website will be accessible using your new domain name.

Troubleshooting Tips

DNS Propagation: If your custom domain isn't working after a few hours, double-check that you entered the DNS records correctly. It's also possible to use a DNS propagation checker tool online.
Incorrect DNS Records: Carefully review the DNS records you entered for any typos or errors.
Firewall Issues: Ensure that your firewall or other network security isn't blocking access to your Bonsai website.
Bonsai Support: If you're still having trouble, contact Bonsai's support team for assistance.

Conclusion: Level Up Your Online Presence

Connecting a custom domain to your Bonsai website is a simple yet effective way to enhance your online presence. By following these steps, you can create a professional and branded website that reflects your personal or business identity. Remember to check Bonsai's official documentation for the most up-to-date and specific instructions for your version.