You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+21-4Lines changed: 21 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -68,7 +68,7 @@ The following AWS IAM policy is a minimal working example to give `libdns` permi
68
68
}
69
69
```
70
70
71
-
## Examples
71
+
## Configuration
72
72
73
73
To use this module for the ACME DNS challenge, configure the ACME issuer in your Caddyfile like so:
74
74
@@ -100,7 +100,10 @@ tls {
100
100
}
101
101
```
102
102
103
-
or with the JSON configuration (see above for comments):
103
+
> [!NOTE]
104
+
> As of 2025, the `region` option is rarely needs to be changed because most AWS Route53 regions use [the same endpoints](https://docs.aws.amazon.com/general/latest/gr/r53.html) as `us-east-1`. It is only required for AWS GovCloud and the China Beijing and Ningxia regions.
105
+
106
+
### JSON configuration example (see above for comments):
104
107
105
108
```json
106
109
{
@@ -129,12 +132,26 @@ When using AWS EC2 instance roles, a minimal Caddy configuration may look like t
129
132
```caddy
130
133
*.caddyexample.example.com {
131
134
tls {
132
-
dns route53 {
133
-
}
135
+
dns route53 {
136
+
}
137
+
}
138
+
}
139
+
```
140
+
141
+
When using AWS access keys, the configuration becomes:
142
+
143
+
```caddy
144
+
*.caddyexample.example.com {
145
+
tls {
146
+
dns route53 {
147
+
access_key_id "AKI..."
148
+
secret_access_key "wJa..."
149
+
}
134
150
}
135
151
}
136
152
```
137
153
138
154
## More information
139
155
140
156
This module is extremely compact and primarily does configuration - the actual Route53 calls are made by [libdns/route53](https://github.com/libdns/route53). Refer to that project for more information.
0 commit comments