mirror of
https://github.com/eliasstepanik/IonosDDNSUpdater.git
synced 2026-01-09 02:28:27 +00:00
IonosDynamicDNSUpdater
This is an automatic Dynamic DNS updater for Ionos written in C#. It uses the Ionos API to request an UpdateURL and updates the DNS record with the current IP address. It also supports running in a Docker container and using Docker Compose.
Prerequisites
To use IonosDynamicDNSUpdater, you need to have the following installed on your system:
- .NET Core (if running outside of a Docker container)
- Docker (if running in a Docker container)
- Docker Compose (if using Docker Compose)
Installation
To install the IonosDynamicDNSUpdater, follow these steps:
- Clone the repository to your local machine using
git clone https://github.com/eliasstepanik/IonosDynamicDNSUpdater.git. - Navigate to the project directory using
cd IonosDynamicDNSUpdater.
Usage
To use the IonosDynamicDNSUpdater, follow these steps:
Running outside of a Docker container
- Create an API token in Ionos.
- Replace the placeholder values in
appsettings.jsonwith your Ionos API token and the hostname for the DNS record you want to update. - Run the application using
dotnet run.
Running in a Docker container
- Build the Docker image using
docker build -t ionosdynamicdnsupdater .. - Run the Docker container using
docker run -d -e API_KEY=<your_api_key> -e DOMAINS=<comma_separated_list_of_domains> ionosdynamicdnsupdater.
Using Docker Compose
- Create an API token in Ionos.
- Replace the placeholder values in
docker-compose.ymlwith your Ionos API token and the hostname for the DNS record you want to update. - Start the services using
docker-compose up -d.
Contributing
To contribute to the IonosDynamicDNSUpdater project, follow these steps:
- Fork the repository.
- Create a new branch for your changes.
- Make your changes and commit them to your branch.
- Submit a pull request to the main repository.
Please make sure to follow the coding style and add appropriate documentation for your changes.
License
This project is licensed under the MIT License.
Contact
For any questions or feedback, please contact the maintainer at eliasstepanik@web.de.
Description
Languages
C#
96.1%
Dockerfile
3.9%