An open API service indexing awesome lists of open source software.

https://github.com/cloud-unpacked/cu-ddns

A dynamic DNS client for Linode.
https://github.com/cloud-unpacked/cu-ddns

cloudflare digitalocean dns dynamic-dns linode

Last synced: about 1 month ago
JSON representation

A dynamic DNS client for Linode.

Awesome Lists containing this project

README

          




Cloud Unpacked


Cloud Unpacked - Dynamic DNS


a Dynamic DNS client for VPS cloud providers


[![Software License](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/cloud-unpacked/cu-ddns/trunk/LICENSE)
![GitHub release (with filter)](https://img.shields.io/github/v/release/cloud-unpacked/cu-ddns)
![Mastodon Follow](https://img.shields.io/mastodon/follow/109867425182016614?domain=https%3A%2F%2Fnanobyte.cafe&style=flat&color=858AFA)
[![Go Report Card](https://goreportcard.com/badge/github.com/cloud-unpacked/cu-ddns)](https://goreportcard.com/report/github.com/cloud-unpacked/cu-ddns)
[![CI Status](https://dl.circleci.com/status-badge/img/gh/cloud-unpacked/cu-ddns/tree/trunk.svg?style=shield)](https://dl.circleci.com/status-badge/redirect/gh/cloud-unpacked/cu-ddns/tree/trunk)

***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][gh-releases].
Many distros allow you to double-click the file to install.
Via terminal, you can do the following:

```bash
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.

```bash
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](./LICENSE).

[gh-releases]: https://github.com/cloud-unpacked/cu-ddns/releases