debian.ansible.dedyn.client/README.md

# DynDNS with dedyn/deSEC (https://desec.io)

This is needed if you want to make services available from the Internet from a changing (dynamic) IP (widely used for private intrnet connections). This may also be needed to validate SSL-ACME-Challenges used by letsencrypt.
deSEC is my preferred DNS provider but there are others too.

# Disclaimer

Use at your own risk.

Please look first at the playbooks downloaded and run by the install.sh to understand whats going on and then decide if it is fine for you to run on your system.

You also should test this on an non-productive Test-System to fit your needs.

# Quick-Install

## 1. Register on the https://desec.io/ website

## 2. Create a domain - Click on + in https://desec.io/domains

## 3. Create a CNAME wildcard for your domain 
  - click on your domain
  - click on "+"
  - Record Set Type: CNAME
  - Subname: *
  - Target hostname: choosen-domainname.dedyn.io.  (finalizing "." is important)
  - click on "Save"

## 4. Get an auth Token
  - click on "Token Management"
  - click on "+"
  - optinally give a name
  - click on "Save"
  - copy your "token's secret value"

## 5. SSH into your Server and write the config customized with your data:

```
echo 'dedynpw="TOKENS_SECRET_VALUE_FROM_DESEC"
dedynhosts="choosen-domainname.dedyn.io"
# should IPv6 be done? possible are "yes", "no" or "only"
doipv6="yes"' >/usr/local/etc/dedyn.conf
```

## 6. Download
``` 
wget https://gitea.ds9.dedyn.io/olli/debian.ansible.basics/raw/branch/main/install.sh
```

## 7. Run the Script
This runs some other Playbooks needed by this playbook.
```
export PLAYBOOKS="
debian.ansible.basics
debian.ansible.runchecks
debian.ansible.autoupdate
debian.ansible.dedyn.client
"
bash install.sh
```

# After the Installation
- When changing IP, the address should update every half hour
- you can manually update with ```sudo dedyn.sh```