Skip to content

feat: Add TencentOS Server to supported distributions #548

@guoningzhang20

Description

@guoningzhang20

Description

The Docker convenience install script (get.docker.com) does not recognize TencentOS Server as a supported distribution. When running the script on TencentOS, it fails at the distribution detection stage because ID=tencentos is not in the list of recognized distributions.

Environment

  • OS: TencentOS Server V4.4
  • /etc/os-release (key fields):
    NAME="TencentOS Server"
    VERSION="4.4"
    ID=tencentos
    ID_LIKE="tencentos"
    VERSION_ID="4.4"
    PLATFORM_ID="platform:el9"
    
  • Arch: x86_64
  • Package Manager: dnf (yum compatible)

Steps to Reproduce

# On a fresh TencentOS Server V4.4 instance:
curl -fsSL https://get.docker.com | sh

The script fails because it cannot identify TencentOS as a supported distribution for Docker CE installation.

Expected Behavior

TencentOS Server should be detected as a RHEL/CentOS-compatible distribution, and Docker CE should be installed using the CentOS/RHEL repository.

Actual Behavior

The install script does not recognize ID=tencentos and exits without installing Docker.

Workaround

Manual installation works fine:

dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
dnf install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
systemctl enable --now docker

This confirms TencentOS is fully compatible with the CentOS Docker repository — it's purely a detection issue in the convenience script.

Suggested Fix

Add tencentos to the distribution detection in install.sh, mapping it to use the CentOS repository:

tencentos)
    # TencentOS Server is RHEL/CentOS compatible
    $sh_c "dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo"
    $sh_c "dnf install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin"
    ;;

Or more robustly, check PLATFORM_ID for platform:el* to cover all EL-compatible distributions.

Additional Context

  • TencentOS Server is a production Linux distribution maintained by Tencent Cloud, serving millions of instances
  • Fully compatible with RHEL/CentOS ecosystem (EL9 based), uses dnf, supports RPM
  • The CentOS Docker repository works perfectly on TencentOS — only the convenience script detection is missing
  • Official site: https://cloud.tencent.com/product/ts
  • This issue was discovered during automated AI usability testing across Linux distributions

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions