github.com/StackExchange/dnscontrol/v4@v4.11.0/documentation/language-reference/domain-modifiers/SOA.md (about)

     1  ---
     2  name: SOA
     3  parameters:
     4    - name
     5    - ns
     6    - mbox
     7    - refresh
     8    - retry
     9    - expire
    10    - minttl
    11    - modifiers...
    12  parameter_types:
    13    name: string
    14    ns: string
    15    mbox: string
    16    refresh: number
    17    retry: number
    18    expire: number
    19    minttl: number
    20    "modifiers...": RecordModifier[]
    21  ---
    22  
    23  `SOA` adds an `SOA` record to a domain. The name should be `@`.  ns and mbox are strings. The other fields are unsigned 32-bit ints.
    24  
    25  {% code title="dnsconfig.js" %}
    26  ```javascript
    27  D("example.com", REG_MY_PROVIDER, DnsProvider(DSP_MY_PROVIDER),
    28    SOA("@", "ns3.example.com.", "hostmaster@example.com", 3600, 600, 604800, 1440),
    29  END);
    30  ```
    31  {% endcode %}
    32  
    33  If you accidentally include an `@` in the email field DNSControl will quietly
    34  change it to a `.`. This way you can specify a human-readable email address
    35  when you are making it easier for spammers how to find you.
    36  
    37  ## Notes
    38  * The serial number is managed automatically.  It isn't even a field in `SOA()`.
    39  * Most providers automatically generate SOA records.  They will ignore any `SOA()` statements.
    40  * The mbox field should not be set to a real email address unless you love spam and hate your privacy.
    41  
    42  There is more info about `SOA` in the documentation for the [BIND provider](../../provider/bind.md).