docs/hugo.yaml

title: Docker Docs
baseURL: https://docs.docker.com
refLinksErrorLevel: ERROR
enableGitInfo: true
disablePathToLower: true
enableInlineShortcodes: true
ignoreLogs:
  - cascade-pattern-with-extension

taxonomies:
  tag: tags
  language: languages

permalinks:
  page:
    manuals: /:sections[1:]/:slugorfilename/
  section:
    manuals: /:sections[1:]/:slugorfilename/

markup:
  tableOfContents:
    startLevel: 2
    endLevel: 3
  goldmark:
    extensions:
      typographer: false
    parser:
      wrapStandAloneImageWithinParagraph: false
      attribute:
        block: true
    renderer:
      unsafe: true
  highlight:
    noClasses: false

related:
  includeNewer: true
  indices:
  - name: keywords
    weight: 80
  - name: fragmentrefs
    applyFilter: false
    type: fragments
    weight: 80
  threshold: 20
  toLower: false

build:
  buildStats:
    enable: true
    disableIDs: true
    disableTags: true
  cachebusters:
    - source: assets/watching/hugo_stats\.json
      target: styles\.css
    - source: (postcss|tailwind)\.config\.js
      target: css
    - source: assets/.*\.js
      target: js
    - source: (assets|layouts)/.*\.(.*)$
      target: "$2"

outputFormats:
  redirects:
    baseName: redirects
    isPlainText: true
    mediaType: "application/json"
    notAlternative: true
  metadata:
    baseName: metadata
    isPlainText: true
    mediaType: "application/json"
    notAlternative: true
  robots:
    baseName: robots
    isPlainText: true
    mediaType: "text/plain"
    notAlternative: true

outputs:
  home:
    - html
    - redirects
    - metadata
    - robots

languages:
  en:
    languageName: English

params:
  kapa:
    id: ba5c2cbc-6535-4334-a72e-050f7a681c8a
  analytics:
    hotjar:
      prod: 3169877
      stage: 3218181
    google: GTM-WL2QLG5
    onetrust: 65425fb0-7b36-4317-9f10-7b3e08039af0
    vwo: 723167
  algolia:
    appid: 3XRLW0LZH9
    apikey: 2899036ce47dba191b8dc1758e4bc6a4
    indexname: docker

  repo: https://github.com/docker/docs
  docs_url: https://docs.docker.com

  latest_engine_api_version: "1.47"
  docker_ce_version: "27.3.1"
  compose_version: "v2.30.3"
  compose_file_v3: "3.8"
  compose_file_v2: "2.4"
  buildkit_version: "0.16.0"

  example_go_version: "1.23"
  example_alpine_version: "3.20"
  example_node_version: "20"

  min_version_thresholds:
    buildx: "0.10.0"
    buildkit: "0.11.0"
    engine: "24.0.0"
    api: "1.41"
    desktop: "4.20.0"
    compose: "2.14.0"
    scout: "1.0.0"

menus:
  main:
  - name: Get started
    pageRef: /get-started/
    weight: 1
  - name: Guides
    pageRef: /guides/
    weight: 2
  - name: Manuals
    pageRef: /manuals/
    weight: 3
  - name: Reference
    pageRef: /reference/
    weight: 4

  footer:
    - url: https://www.docker.com/products
      name: Product offerings
    - url: https://www.docker.com/products/personal
      name: Docker Personal
      parent: Product offerings
    - url: https://www.docker.com/products/pro
      name: Docker Pro
      parent: Product offerings
    - url: https://www.docker.com/products/team
      name: Docker Team
      parent: Product offerings
    - url: https://www.docker.com/products/business
      name: Docker Business
      parent: Product offerings
    - url: https://www.docker.com/pricing/faq
      name: Pricing FAQs
      parent: Product offerings
    - url: https://www.docker.com/partners/programs
      name: Docker Verified Publisher
      parent: Product offerings
    - url: https://www.docker.com/partners
      name: Partners
      parent: Product offerings

    - url: https://www.docker.com/
      name: Features
    - url: https://www.docker.com/products/docker-desktop
      name: Docker Desktop
      parent: Features
    - url: https://www.docker.com/products/docker-hub
      name: Docker Hub
      parent: Features
    - url: https://www.docker.com/products/secure-software-supply-chain
      name: Secure Software Supply Chain
      parent: Features
    - url: https://www.docker.com/products/container-runtime
      name: Container Runtime
      parent: Features
    - url: https://www.docker.com/products/developer-tools
      name: Developer Tools
      parent: Features
    - url: https://www.docker.com/partners
      name: Trusted Content
      parent: Features
    - url: https://www.docker.com/roadmap
      name: Docker Product Roadmap
      parent: Features

    - name: Developers
    - url: https://www.docker.com/use-cases
      name: Use cases
      parent: Developers
    - url: /get-started/
      name: Get started
      parent: Developers
    - url: https://www.docker.com/blog/
      name: Blog
      parent: Developers
    - url: https://www.docker.com/docker-community
      name: Community
      parent: Developers
    - url: https://www.docker.com/open-source
      name: Open Source
      parent: Developers
    - url: https://www.docker.com/community/get-involved/developer-preview
      name: Preview Program
      parent: Developers

    - url: https://www.docker.com/company
      name: About us
    - url: https://www.docker.com/what-container
      name: What is a container?
      parent: About us
    - url: https://www.docker.com/why-docker
      name: Why Docker?
      parent: About us
    - url: https://www.docker.com/events
      name: Virtual events
      parent: About us
    - url: https://www.docker.com/swag
      name: Swag store
      parent: About us
    - url: https://www.docker.com/company/newsroom
      name: Newsroom
      parent: About us
    - url: https://www.docker.com/careers
      name: Careers
      parent: About us
    - url: https://www.docker.com/company/contact
      name: Contact us
      parent: About us
    - url: https://www.docker.com/customers
      name: Customers
      parent: About us
    - url: https://www.docker.com/newsletter-subscription
      name: Newsletter
      parent: About us

module:
  proxy: https://proxy.golang.org,direct
  hugoVersion:
    extended: false
    min: "0.139.0"
  mounts:
    - source: assets
      target: assets
    - source: hugo_stats.json
      target: assets/watching/hugo_stats.json
    - source: node_modules/@material-symbols/svg-400/rounded
      target: assets/icons

  imports:

    - path: github.com/moby/moby
      mounts:
        - source: docs/api/v1.24.md
          target: content/reference/api/engine/version/v1.24.md
        - source: docs/api/version-history.md
          target: content/reference/api/engine/version-history.md
        - source: docs/api
          target: content/reference/api/engine/version
          includeFiles: "*.yaml"

    - path: github.com/moby/buildkit
      mounts:
        - source: frontend/dockerfile/docs/reference.md
          target: content/reference/dockerfile.md
        - source: frontend/dockerfile/docs/rules
          target: content/reference/build-checks
          includeFiles: "*.md"
        - source: docs/buildkitd.toml.md
          target: content/manuals/build/buildkit/toml-configuration.md
        - source: docs/attestations/slsa-definitions.md
          target: content/manuals/build/metadata/attestations/slsa-definitions.md
        - source: docs/attestations/attestation-storage.md
          target: content/manuals/build/metadata/attestations/attestation-storage.md

    - path: github.com/docker/buildx
      mounts:
        - source: docs/bake-reference.md
          target: content/manuals/build/bake/reference.md

    - path: github.com/docker/cli
      mounts:
        - source: docs/extend
          target: content/manuals/engine/extend
          excludeFiles:
            - "EBS_volume.md"
            - "plugins_metrics.md"
            - "plugins_services.md"
        - source: docs/deprecated.md
          target: content/manuals/engine/deprecated.md
        - source: docs/reference/run.md
          target: content/manuals/engine/containers/run.md
        - source: docs/reference/dockerd.md
          target: content/reference/cli/dockerd.md

    - path: github.com/docker/compose/v2
      mounts:
        - source: docs/reference
          target: data/compose-cli
          includeFiles: "*.yaml"

    - path: github.com/docker/scout-cli
      mounts:
        - source: docs
          target: data/scout-cli
          includeFiles: "*.yaml"