Skip to content

Service to update AWS Route53 with current public IP address; Service for my homelab

Notifications You must be signed in to change notification settings

joshbeard/homelab-service-route53ddns

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Route53 Dynamic DNS Updater

This uses the sjmayotte/route53-dynamic-dns Docker image and utility to maintain DNS records for my home's dynamic IP address.

Usage

Refer to the upstream project for detailed usage documentation.

The container expects a .env file to be provided with environment variables. I've provided .env.example for a reference. The utility relies on an AWS access key with minimal rights to the Route53 zone. These are maintained in the Terraform codebase that manages the jbeard.dev AWS resources, including Route53.

Once a .env file is configured, simply start the service with docker-compose:

docker-compose up

Configuration

The configuration uses environment variables.

For deployments on my homelab, the GitLab CI/CD vars are used for specifying configurations.

These are protected file variables.

Refer to the .env.example.

AWS_ACCESS_KEY_ID=AKXXXXXXXXXXXXXXXXQR
AWS_SECRET_ACCESS_KEY=mq7vyxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/B
AWS_REGION=us-west-2
ROUTE53_DOMAIN=foo.co
ROUTE53_HOSTED_ZONE_ID=Z04xxxxxxxxxxxxxxxxxR
ROUTE53_TTL=300
ROUTE53_TYPE=A
LOG_TO_STDOUT=true

About

Service to update AWS Route53 with current public IP address; Service for my homelab

Topics

Resources

Stars

Watchers

Forks