> ## Documentation Index
> Fetch the complete documentation index at: https://bunnynet-cb9733c2-docs-dns-cli-tabs-and-scriptable-types.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Create and configure your first DNS Zone in minutes.

This guide walks you through adding a DNS Zone to bunny.net and configuring your domain to use Bunny DNS.

<Tabs>
  <Tab title="Dashboard">
    <Steps>
      <Step title="Create a new DNS Zone">
        In the bunny.net dashboard, go to **DNS** and click **Add DNS Zone**, or select it from the **+ Add** sidebar launcher.

        <Frame>
          <img src="https://mintcdn.com/bunnynet-cb9733c2-docs-dns-cli-tabs-and-scriptable-types/AOPbvCaByTB9PIw_/images/dns/add-dns-zone.png?fit=max&auto=format&n=AOPbvCaByTB9PIw_&q=85&s=7f707803a3bc9ef975164bd3b04a48aa" alt="Add DNS Zone" width="1310" height="602" data-path="images/dns/add-dns-zone.png" />
        </Frame>
      </Step>

      <Step title="Enter your domain">
        Type your domain name (e.g., `mywebsite.com`) to start the setup process.

        <Frame>
          <img src="https://mintcdn.com/bunnynet-cb9733c2-docs-dns-cli-tabs-and-scriptable-types/AOPbvCaByTB9PIw_/images/dns/enter-domain.png?fit=max&auto=format&n=AOPbvCaByTB9PIw_&q=85&s=4406587b780c649396f4718e205a110b" alt="Enter domain" width="1112" height="382" data-path="images/dns/enter-domain.png" />
        </Frame>
      </Step>

      <Step title="Import records">
        Now that you've entered your domain, you can import any existing DNS records.

        <Frame>
          <img src="https://mintcdn.com/bunnynet-cb9733c2-docs-dns-cli-tabs-and-scriptable-types/AOPbvCaByTB9PIw_/images/dns/scan-or-upload.png?fit=max&auto=format&n=AOPbvCaByTB9PIw_&q=85&s=f40dd5503d8afc2ebd9ccde4b9fc90b8" alt="Scan or upload" width="1960" height="722" data-path="images/dns/scan-or-upload.png" />
        </Frame>

        <Tabs>
          <Tab title="Auto-import or add manually">
            Select this option to have Bunny DNS scan and fetch your existing DNS records automatically. You can review and edit them before switching, or start from scratch.

            The scanning process can take several minutes depending on your domain's complexity.
          </Tab>

          <Tab title="Upload Zone File">
            Drag and drop a DNS zone file (such as a BIND zone file), or click **Upload Zone File** to import all records at once.

            This is useful when migrating from providers that support zone file exports.

            [Learn more about importing zone files](/dns/import-export)
          </Tab>
        </Tabs>

        Click **Next** to continue.
      </Step>

      <Step title="Review your records">
        After scanning or importing, review your DNS records carefully:

        * Compare detected records with your current DNS provider
        * Add any missing records that weren't detected
        * Remove or modify records as needed
        * Check that critical records like MX (email) and CNAME entries are correct

        <Frame>
          <img src="https://mintcdn.com/bunnynet-cb9733c2-docs-dns-cli-tabs-and-scriptable-types/AOPbvCaByTB9PIw_/images/dns/review-dns-records.png?fit=max&auto=format&n=AOPbvCaByTB9PIw_&q=85&s=7016e888e9521a8fdfacdac38c2fb9d9" alt="Review records" width="1502" height="752" data-path="images/dns/review-dns-records.png" />
        </Frame>
      </Step>

      <Step title="Confirm and add">
        Once you've verified your records, choose how to proceed:

        * **Confirm and add** creates the DNS Zone with your imported or configured records
        * **Add DNS Zone without records** creates an empty DNS Zone that you can populate manually

        <Frame>
          <img src="https://mintcdn.com/bunnynet-cb9733c2-docs-dns-cli-tabs-and-scriptable-types/AOPbvCaByTB9PIw_/images/dns/confirm-and-add.png?fit=max&auto=format&n=AOPbvCaByTB9PIw_&q=85&s=c3b44c5f23e1ebc3683782ee58144e70" alt="Confirm and add" width="916" height="284" data-path="images/dns/confirm-and-add.png" />
        </Frame>

        Click your preferred option to create the zone.
      </Step>

      <Step title="Update your nameservers">
        After creating your DNS Zone, update your domain's nameservers at your domain registrar to point to Bunny DNS:

        * `kiki.bunny.net`
        * `coco.bunny.net`

        The process varies by registrar, but typically involves logging in to your registrar's control panel and replacing the existing nameservers with the ones above.

        <Info>DNS propagation can take up to 48 hours, though changes typically take effect within a few hours.</Info>
      </Step>
    </Steps>
  </Tab>

  <Tab title="CLI">
    <Note>
      Don't have the CLI installed? See the [CLI quickstart](/cli/quickstart) to install and authenticate.
    </Note>

    <Steps>
      <Step title="Create a new DNS Zone">
        ```bash theme={null}
        bunny dns zones add example.com
        ```

        After creating the zone, the CLI checks your domain's live registrar delegation. If the domain already points at Bunny DNS, it simply confirms. Otherwise it prints the nameservers to set, naming your registrar when it can detect it.
      </Step>

      <Step title="Add or import records">
        Import an existing BIND zone file, or add records individually:

        ```bash theme={null}
        # Import a BIND zone file exported from your current provider
        bunny dns records import example.com ./zonefile.txt

        # Or add records one by one (use '@' for the zone apex)
        bunny dns records add example.com api A 198.51.100.1
        bunny dns records add example.com '@' MX mail.example.com 10

        # Or apply a preset record set for a common provider (email, verification, security)
        bunny dns records preset google-workspace example.com
        ```

        Run `bunny dns records add` with no arguments for an interactive wizard, and `bunny dns records list example.com` to review the result.
      </Step>

      <Step title="Update your nameservers">
        Update your domain's nameservers at your domain registrar to point to Bunny DNS:

        * `kiki.bunny.net`
        * `coco.bunny.net`

        Then verify the delegation has taken effect:

        ```bash theme={null}
        bunny dns zones nameservers example.com
        ```

        This does a live nameserver lookup and confirms once your registrar delegates to Bunny DNS.

        <Info>DNS propagation can take up to 48 hours, though changes typically take effect within a few hours.</Info>
      </Step>
    </Steps>

    See the [`bunny dns` command reference](/cli/commands/dns) for the full list of zone, record, and script commands.
  </Tab>
</Tabs>

## Next steps

Your DNS Zone is now active. From here you can:

<CardGroup cols={2}>
  <Card title="Manage DNS Records" href="/dns/records">
    Add, edit, and configure DNS records for your domain.
  </Card>

  <Card title="Enable DNSSEC" href="/dns/dnssec">
    Protect your domain from spoofing and tampering.
  </Card>

  <Card title="Scriptable DNS" href="/dns/scriptable/introduction">
    Write JavaScript to dynamically respond to DNS queries.
  </Card>

  <Card title="View Statistics" href="/dns/statistics">
    Monitor DNS query traffic and patterns.
  </Card>
</CardGroup>
