---
name: "systemd.rr"
section: "5"
platform: "linux"
package: "systemd"
version: "262.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/systemd.rr"
---

# systemd.rr(5)

Local static DNS resource record definitions

## NAME

systemd.rr - Local static DNS resource record definitions

## SYNOPSIS

/etc/systemd/resolve/static.d/\*.rr

/run/systemd/resolve/static.d/\*.rr

/usr/local/lib/systemd/resolve/static.d/\*.rr

/usr/lib/systemd/resolve/static.d/\*.rr

## DESCRIPTION

\*.rr files may be used to define resource record sets ("RRsets") that shall be resolvable locally, similar in style to address records defined by /etc/hosts (see [**hosts**(5)](/hosts/5.md) for details). These files are read by [**systemd-resolved.service**(8)](/systemd-resolved.service/8.md), and are used to synthesize local responses to local queries matching the defined resource record set.

These drop-in files are in JSON format. Each file may either contain a single top-level DNS RR object, or an array of one or more DNS RR objects. Each RR object has at least a "key" subobject consisting of a "name" string field and a "type" integer field (which contains the RR type in numeric form). Depending on the chosen type the RR object also has the following fields:

• For A/AAAA RRs, the RR object should have an "address" field set to either an IP address formatted as string, or an array consisting of 4 or 16 8-bit unsigned integers for the IP address.

• For PTR/NS/CNAME/DNAME RRs, the RR object should have a "name" field set to the name the record shall point to.

This JSON serialization of DNS RRs matches the one returned by **resolvectl**.

Currently no other RR types are supported.

## EXAMPLES

**Example 1. Simple A Record**

To make local address lookups for "foobar.example.com" resolve to the 192.168.100.1 IPv4 address, create /run/systemd/resolve/static.d/foobar\_example\_com.rr:

```
{
        "key" : {
                "type" : 1,
                "name" : "foobar.example.com"
        },
        "address" : [ 192, 168, 100, 1 ]
}
```

## SEE ALSO

[**systemd**(1)](/systemd/1.md), [**systemd-resolved.service**(8)](/systemd-resolved.service/8.md), [**resolved.conf**(5)](/resolved.conf/5.md), [**hosts**(5)](/hosts/5.md), [**resolvectl**(1)](/resolvectl/1.md)