---
# System prepended metadata

title: Cloudflare DNS Update Helper

---

# Cloudflare DNS Update Helper

A **very** basic Node-based CLI tool to easily manage **most** DNS records via Cloudflare's API.

**Note:** While this tool does support any record types supported by CloudFlare, it does not additional values such as priority, round-robin entries (multiple A records for the same hostname), and other advanced uses. This tool is designed for simply creating, updating, and deleting singular entry hostname records by type.

### Installation

```bash
git clone https://gitlab.velocity.org/blehmann/cf-dns-updater.git
cd cf-dns-updater
npm link
```

### Usage

You must make your Cloudflare API token available via an environment variable before issuing any CLI commands. The proper environment variable is `CLOUDFLARE_API_KEY`.

**Example:** `export CLOUDFLARE_API_KEY="fx#3y8k2qRP%qqVNH%5R@3J78"`

The script will exit `0` if successful otherwise it will exit `1` so that it can be called by other tools.

#### Add a New Record

```bash
cf-dns-updater -a add -h newdb.vselect.com -t CNAME -v writedb.vselect.com
```

#### Update a Record

```bash
cf-dns-updater -a update -h writedb.vselect.com -t A -v 4.30.174.28
```

**Note:** Updating a record will automatically request that the DNS servers at 1.1.1.1 purge the record for the given hostname.

#### Delete a Record

```bash
cf-dns-updater -a delete -h newdb.vselect.com -t CNAME
```

