Skip to content
Bitelex Docs

Dinio CLI

dinio manages Dinio from a terminal — both DNS hosting and DNS filtering. It uses names the way you think about DNS — dinio record add example.com www A 192.0.2.1 — and looks up the uuids for you.

Install

Section titled “Install”

On Debian and Ubuntu:

Terminal window
sudo apt install dinio   # after adding the Dinio apt repository

The repository setup, rpm, a plain Linux archive and the Windows installer are on Install.

Connect

Section titled “Connect”

  1. Save your API key in the default profile. It is read hidden from the terminal (or from stdin) and never passed as an argument, so it stays out of your shell history:

    Terminal window
    dinio profile set-key default

  2. Check that Dinio is reachable and the key works:

    Terminal window
    dinio auth status
    profile  default
    url      https://api-dinio.bitelex.com
    email    -
    core     ok (db up, nats up, version 1.0.0)
    key      valid personal key, 2 zone(s) visible

First steps

Section titled “First steps”
Terminal window
dinio zone create example.com
dinio record add example.com www A 192.0.2.1 --ttl 300
dinio record add example.com @ MX 10 mail.example.com
dinio record list example.com --type A
NAME  TYPE  TTL  DATA       OPTIONS
www   A     300  192.0.2.1

Moving a domain from another provider? dinio zone discover finds its records, and dinio zone import brings them in.

Every command has --help:

Terminal window
dinio --help
dinio record add --help

Commands

Section titled “Commands”
Command
dinio profile Connection profiles: URL, API key, email.
dinio auth status Is Dinio reachable, does the key work.
dinio me Your account; issue or revoke your personal key.
dinio plan, dinio usage Compare and choose packages; what you use of their limits.
dinio completion Shell completion scripts.

DNS hosting

Command
dinio zone List, create, delete zones; issue or revoke a zone key.
dinio zone export, import, discover Zone files, and moving a zone from another provider.
dinio free-domain Lease a subdomain of a free domain as your zone.
dinio record List, add, change, remove records; set a TTL.
dinio health The health check of a record value.
dinio geo-ban Hide a record value from countries or regions.
dinio member Who has access to a zone.
dinio redirect HTTP(S) redirects for host names in your zones.
dinio cert TLS certificates for names in your zones.

DNS filtering — needs a personal key

Command
dinio client The devices and networks you filter for.
dinio sinkhole Blacklists and whitelists, their rules, links to clients; import, export and URL sources.

Both

Command
dinio stats Statistics of your zones and your clients.
dinio audit Who did what on your account and zones.