Skip to content

Commit 48047d4

Browse files
authored
Add more context about disabling DNS server in docs (localstack#11524)
1 parent 1786ed9 commit 48047d4

File tree

1 file changed

+5
-2
lines changed

1 file changed

+5
-2
lines changed

docs/development-environment-setup/README.md

+5-2
Original file line numberDiff line numberDiff line change
@@ -55,8 +55,11 @@ Refer to our official [Dockerfile](https://github.com/localstack/localstack/blob
5555

5656
#### Root Permissions
5757

58-
* Set `DNS_ADDRESS=0` to disable the LocalStack [DNS server](https://docs.localstack.cloud/user-guide/tools/dns-server/)
59-
if you are getting the error "cannot run command as root" because the DNS server tries to bind port 53.
58+
LocalStack runs its own [DNS server](https://docs.localstack.cloud/user-guide/tools/dns-server/) which listens for requests on port 53. This requires root permission. When LocalStack starts in host mode it runs the DNS server as sudo, so a prompt is triggered asking for the sudo password. This is annoying during local development, so to disable this functionality, use `DNS_ADDRESS=0`.
59+
60+
> [!NOTE]
61+
> We don't recommend disabling the DNS server in general (e.g. in Docker) because the [DNS server](https://docs.localstack.cloud/user-guide/tools/dns-server/) enables seamless connectivity to LocalStack from different environments via the domain name `localhost.localstack.cloud`.
62+
6063

6164
#### Python Dependencies
6265

0 commit comments

Comments
 (0)