scaleway-ddns (v2.0.1)

Simple Scaleway dynamic DNS service by API written in Crystal.

🚀 Suggestions for new improvements are welcome in the issue tracker.

Installation and Usage

Docker

With docker run command :

docker run -d \
  -e SCW_SECRET_KEY="super-secret-from-scaleway" \
  -e IDLE_MINUTES="10" \
  -e DOMAIN_LIST="myfirstdomain.com,anotherone.com" \
  -e ENABLE_IPV4="true" \
  -e ENABLE_IPV6="false" \
  d1ceward/scaleway-ddns:latest

With docker-compose file :

---
services:
  scaleway_ddns:
    image: d1ceward/scaleway-ddns:latest
    restart: unless-stopped
    environment:
      SCW_SECRET_KEY: super-secret-from-scaleway
      IDLE_MINUTES: 10
      DOMAIN_LIST: myfirstdomain.com,anotherone.com
      ENABLE_IPV4: true # Optional, enables IPv4 address updates (default: true)
      ENABLE_IPV6: true # Optional, enables IPv6 address updates (default: false)

Linux

Download the executable file :

wget --no-verbose -O scaleway-ddns https://github.com/d1ceward/scaleway-ddns/releases/download/v2.0.1/scaleway-ddns-linux-amd64

Modify the executable's permissions :

chmod +x scaleway-ddns

Execution example :

scaleway-ddns run

Documentation available here : https://d1ceward.github.io/scaleway-ddns/

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/d1ceward/scaleway-ddns. By contributing you agree to abide by the Code of Merit.

1. Fork it (https://github.com/d1ceward/scaleway-ddns/fork)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

Development building and running

1. Install corresponding version of Crystal lang (cf: .crystal-version file)
2. Install Crystal dependencies with shards install
3. Build with shards build

The newly created binary should be at bin/scaleway-ddns

Running tests

crystal spec

Environment Variables

• SCW_SECRET_KEY (required): Secret key from Scaleway required for IP update.
• IDLE_MINUTES: Number of minutes of inactivity between IP checks (default: 60, min: 1, max: 1440).
• DOMAIN_LIST: Comma-separated list of domains to update (e.g., example.com,another.com).
• ENABLE_IPV4: Enables IPv4 address updates. Set to false to disable (default: true).
• ENABLE_IPV6: Enables IPv6 address updates. Set to true to enable (default: false).

Contributors

• d1ceward - creator and maintainer