Skip to main content
Manage local DNS domains for containers. Allows creating, listing, and deleting DNS domains.

​
Subcommands

​
create

Creates a local DNS domain for containers. Requires administrator privileges (use sudo). Usage: 
container system dns create [--debug] <domain-name>
Arguments:
  • <domain-name> - The local domain name
Example: 
sudo container system dns create test

​
list

Lists configured local DNS domains for containers. Usage: 
container system dns list [--debug]
Alias: container system dns ls Example: 
container system dns list

​
delete

Deletes a local DNS domain. Requires administrator privileges (use sudo). Usage: 
container system dns delete [--debug] <domain-name>
Alias: container system dns rm Arguments:
  • <domain-name> - The local domain name
Example: 
sudo container system dns delete test

​
Common workflow

1

Create a DNS domain

Create a local DNS domain (requires sudo):
sudo container system dns create test
2

Set as default domain

Make it the default domain for containers:
container system property set dns.domain test
3

Access containers by name

Now you can access containers by their name:
container run --name web nginx:latest
open http://web.test
DNS domains simplify accessing containers by allowing you to use memorable names instead of IP addresses.
Creating and deleting DNS domains requires administrator privileges because it modifies system DNS configuration.

Build docs developers (and LLMs) love

Get started for freeTalk to us