To Serve Admin

A practical cookbook for people who run servers

Linux · DevOps · Networking · Homelab · Cloud · Game Servers · AI Infra

§ 1.1 Guide

Claiming a Free .arpa Domain for Homelab Reverse DNS

FIG. 1 — tsa-hero-66
YieldYou will have a free .arpa subdomain configured for stable reverse DNS lookups.

Understanding the .arpa Namespace for Internal Services

The .arpa domain exists specifically for reverse DNS lookups. Unlike standard public domains, it is not intended for forward resolution (mapping names to IPs) but for mapping IP addresses back to names. For homelab operators, this namespace offers a critical advantage: you can claim a free subdomain under .arpa without paying for a commercial domain. This provides stable reverse DNS for internal services, eliminating the need to purchase a separate domain solely for PTR records.

Traditionally, reverse DNS is managed by the IP address provider. If you are on a residential connection, your ISP controls the PTR records for your public IP. This creates a dependency: if you change ISPs, or if they fail to update records, your reverse lookup breaks. By claiming a subdomain under .arpa, you decouple your internal reverse DNS from your upstream provider. You own the namespace. You control the records. It is free.

This method is not a replacement for public reverse DNS if you need it for email deliverability or public-facing services. It is a tool for internal infrastructure. It allows you to map internal IP addresses (or even public IPs, if you control the resolution) to meaningful hostnames. The process involves the ARPA registry, which manages the .arpa zone. The guide focuses on the initial claim and basic record setup. Specific reverse-proxy software configuration is out of scope.

Prerequisites and Registry Access

Before you can claim a subdomain, you need access to the ARPA registry. The registry is managed by the IANA, but the actual registration process is handled through a specific portal. You do not need to be a large organization or have a business registration. Individual homelab operators are eligible to claim subdomains.

You will need:

  • A valid email address for account verification and notifications.
  • A clear idea of the subdomain you want to claim. It should be unique. For example, myhomelab.arpa or johnsmith-lab.arpa. Avoid generic names like test.arpa or home.arpa, as they are likely already taken or reserved.
  • Basic DNS knowledge. You should understand what A, AAAA, and PTR records are. If you are new to DNS, review the basics before proceeding.

The ARPA registry does not provide a web-based GUI for managing records. You will interact with it via a registration form and then manage your records through a DNS provider or your local resolver. This is a key difference from standard domain registrars. You are claiming the namespace, not buying a hosted DNS service.

Step-by-Step: Claiming Your Subdomain

The claim process is straightforward but requires attention to detail. Follow these steps:

  1. Navigate to the ARPA Registry Portal. The primary source for this process is documented by community guides, such as this detailed walkthrough. The official registry interface is accessible via the IANA ARPA zone management tools. Look for the “Register a Subdomain” or similar link. The URL may vary, but the process is consistent.
  2. Fill out the registration form. You will be asked for your email address, the desired subdomain name, and a brief description of your use case. Be honest and specific. “Homelab reverse DNS for personal infrastructure” is a valid use case. Avoid vague descriptions.
  3. Verify your email. The registry will send a verification email. Click the link to confirm your ownership. This step is mandatory. Without verification, your claim will be rejected.
  4. Wait for approval. Approval is usually fast, often within minutes to a few hours. You will receive a confirmation email once your subdomain is registered. If it is rejected, check the email for reasons. Common issues include an already-taken name or an invalid email format.

Once approved, you own the subdomain. You can now use it for reverse DNS lookups. For example, if you claimed myhomelab.arpa, you can create a PTR record for the IP 192.168.1.10 that points to server1.myhomelab.arpa.

Configuring Basic Reverse Lookup Records

Now that you have your subdomain, you need to configure reverse lookup records. This is where you map IP addresses to hostnames. The specific method depends on your DNS setup. Here are examples using common local resolvers:

BIND: In your BIND configuration, you will define a reverse zone for your subdomain. For example, if your internal network is 192.168.1.0/24, you might create a zone for 1.168.192.in-addr.arpa or, more likely for this use case, a custom zone like myhomelab.arpa. You will add PTR records pointing to your internal hostnames. The zone file will look something like this:

$ORIGIN myhomelab.arpa.
@       IN      SOA     ns1.myhomelab.arpa. admin.myhomelab.arpa. (
                        2023102701 ; Serial
                        3600       ; Refresh
                        900        ; Retry
                        604800     ; Expire
                        86400 )    ; Minimum
@       IN      NS      ns1.myhomelab.arpa.
10      IN      PTR     server1.myhomelab.arpa.
11      IN      PTR     server2.myhomelab.arpa.

dnsmasq: dnsmasq is a lightweight DNS server often used in homelabs. You can configure reverse lookups by adding a address or host-record directive. For example, to map 192.168.1.10 to server1.myhomelab.arpa, you can add:

host-record=server1.myhomelab.arpa,192.168.1.10

dnsmasq will handle the reverse lookup automatically if configured correctly. Ensure that your clients are pointing to dnsmasq as their DNS server.

systemd-resolved: If you are using systemd-resolved on Linux, you can configure stub domains. In /etc/systemd/resolved.conf, add:

[Resolve]
DNSStubListener=yes
Domains=myhomelab.arpa

Then, configure your reverse zone in /etc/resolvectl or via a custom DNS server like dnsmasq that systemd-resolved delegates to. systemd-resolved itself does not manage zones; it delegates to upstream servers.

Verifying Resolution with Common Tools

After configuring your records, you must verify that reverse lookups work. Use standard DNS tools to test:

  • dig: Use dig -x to perform a reverse lookup. For example:
dig -x 192.168.1.10 @192.168.1.1

Replace 192.168.1.1 with your local DNS server’s IP. The output should show a PTR record pointing to server1.myhomelab.arpa.

  • nslookup: Use nslookup with the IP address. It will perform a reverse lookup by default.
nslookup 192.168.1.10
  • host: Use host with the IP address.
host 192.168.1.10

If the lookup fails, check your DNS server configuration. Ensure that the reverse zone is defined and that the PTR records are correct. Also, verify that your clients are using the correct DNS server. If you are using multiple DNS servers, ensure that all of them have the same configuration.

Next Steps: Integrating with Local Resolvers

Once your reverse lookups are working, you can integrate them with your local resolvers. This ensures that all devices on your network can resolve reverse lookups consistently. For example, if you are using dnsmasq, ensure that all your clients are pointing to dnsmasq as their DNS server. If you are using systemd-resolved, ensure that it is delegating to dnsmasq for your .arpa domain.

This integration is crucial for services that rely on reverse DNS, such as logging, authentication, and monitoring. Without it, these services may fail to resolve hostnames, leading to errors or incomplete logs.

Remember, this guide focuses on the initial claim and basic record setup. Specific reverse-proxy software configuration is out of scope. If you need to configure Caddy or Nginx to use your new domain, refer to their respective documentation. This article provides the foundation for stable reverse DNS in your homelab.

§ adj. Did this recipe work for you?

§ notes Reader notes

LEAVE A NOTE — field-tested feedback only, please

notes are reviewed before publication. No spam, no ads, no “first”-type nonsense.