Skip to content

cloud-unpacked/cu-ddns

Repository files navigation

Cloud Unpacked

Cloud Unpacked - Dynamic DNS

a Dynamic DNS client for VPS cloud providers

Software License GitHub release (with filter) Mastodon Follow Go Report Card CI Status

This project is brand new and in alpha right now. You may notice a lack of polish and/or drastic changes.

cu-ddns is a dynamic DNS client that uses VPS cloud providers such as Linode for DNS. This tool allows pointing a DNS hostname such as home.example.com to an IP address that may change regularly. The typical scenario is having a domain name point to your home IP address however those that travel a lot would find it useful as well.

Table of Contents

  • Installing
  • Configuring
  • Features

Providers

cu-ddns supports the following providers:

  • Linode DNS
  • Cloudflare DNS

Installing

Debian Package (.deb) Instructions

Download the .deb file to the desired system.

For graphical systems, you can download it from the GitHub Releases page. Many distros allow you to double-click the file to install. Via terminal, you can do the following:

wget https://github.com/cloud-unpacked/cu-ddns/releases/download/v0.1.0/cu-ddns_0.1.0_amd64.deb
sudo dpkg -i cu-ddns_0.1.0_amd64.deb

0.1.0 and amd64 may need to be replaced with your desired version and CPU architecture respectively.

Configuring

After installation, run the setup command to setup the client and the start command to start it running.

sudo cu-ddns setup
sudo cu-ddns start

Cloudflare

When creating the Cloudflare API token, the following permissions are needed: All zones - Zone:Edit, DNS:Edit.

Features

Multiple Providers - Linode and Cloudflare are supported. DigitalOcean DNS next on the list.

IPv4/6 Support - IPv4 is supported with IPv6 coming in the near future.

License

This repository is licensed under the MIT license. The license can be found here.