Self-host Cloudflare DDNS on a VPS
Keeps Cloudflare DNS records pointed at your current public IP address.
levelrail-cli templates deploy cloudflare-ddns --name my-cloudflare-ddnsSpecification
- Status
- Listed
- Category
- Infrastructure
- Services
- cloudflare-ddns
- Ports
- none
- Volumes
- 0
- Memory
- about 32 MiB
- arm64
- image published
- amd64
- image published
- Settings to fill in
- none
- License
- Permissive license, Apache-2.0
About Cloudflare DDNS
Required: CLOUDFLARE_API_TOKEN (a token with DNS edit rights for the zone) and DOMAINS (comma separated records to keep updated).
What it deploys
Cloudflare DDNS runs as one service in a single Compose app.
| Service | Image | Tag | Ports | Volumes |
|---|---|---|---|---|
| cloudflare-ddns | favonia/cloudflare-ddns | 1.15.1 | none | none |
Before you install
- CPU architecture. arm64 listed. Every image lists linux/arm64 in its registry manifest. That is a manifest fact, not proof the app runs on Arm.
- Listed. It is in the catalog. Back up the data volume before changing an image tag.
Settings and environment
You do not have to fill in anything. Values are never shown here.
| Service | Variable | Value |
|---|---|---|
| cloudflare-ddns | CLOUDFLARE_API_TOKEN | Preset by the template |
| cloudflare-ddns | DOMAINS | Preset by the template |
| cloudflare-ddns | PROXIED | Preset by the template |
Install Cloudflare DDNS on a VPS
-
Install Levelrail on a fresh VPS
Run this as root on a Linux server (amd64 or arm64) with ports 80 and 443 reachable. The installer prints a setup link.
curl -fsSL https://levelrail.com/install.sh | sudo sh -
Sign in
Open the setup link, choose a password, then log the CLI in. The CLI install command is
curl -fsSL https://levelrail.com/install-cli.sh | shif the machine does not have it. See Getting started.levelrail-cli login --device -
Read the template
Shows the entry, including its full compose.yaml.
levelrail-cli templates get cloudflare-ddns -
Deploy it
This deploys the template compose file as an app. The app name defaults to the template id; --name sets another.
levelrail-cli templates deploy cloudflare-ddns --name my-cloudflare-ddns
Without a domain the app gets an sslip.io address. You can also deploy it from the dashboard: Apps, New app, Browse templates, then Cloudflare DDNS.
Docs and upstream
More in Infrastructure
- ChiselA fast TCP and UDP tunnel over HTTP secured by SSH, for reaching services behind firewalls. MIT licensed. The tunnel password is generated for you.
- ConsulHashiCorp Consul in single-server mode with the web UI: service discovery, health checks and a key-value store.
- CaddyA fast web server with automatic HTTPS and a simple config file, on the official image serving its default page. Mount your own Caddyfile or site files to host real sites.
- ElasticsearchA distributed, RESTful search and analytics engine for full-text search and log analytics. Security is off, so reach it from other services in this project at elasticsearch:9200, or attach a domain only behind Basic Auth. Not published on the host.
- EMQXA scalable MQTT broker for IoT and smart home devices with a web dashboard.
- Envoy ProxyCloud native edge and service proxy on the official image. The install form carries envoy.yaml as an editable file, so it starts with a working listener instead of exiting on a missing config.