Adds alternate DNS names for a service on a network.

Section: Ports and Networks

Set network aliases

yaml
yaml
services:
  api:
    image: myapi:latest
    networks:
      backend:
        aliases:
          - internal-api

networks:
  backend: {}
Explanation

Useful when multiple apps expect a specific hostname.

Learn the surrounding workflow

Compare similar commands or jump into common fixes when this command is part of a bigger troubleshooting path.

Related commands

Same sheet · prioritizing Ports and Networks
Publish container port
Maps host port 8080 to container port 80.
OpenIn sheetyamlsame section
Bind only on localhost
Publishes the service only to the local machine.
OpenIn sheetyamlsame section
Attach services to custom network
Defines multiple named networks for segmentation.
OpenIn sheetyamlsame section
Resolve published port
Shows the host binding for a service port.
OpenIn sheetbashsame section
Named volume for persistent data
Stores database data in a managed named volume.
OpenIn sheetyaml2 tag match
Mount a secret file
Mounts a file-backed secret into the container.
OpenIn sheetyaml2 tag match