docker / docker/docker-install

feat: Add TencentOS Server to supported distributions

Open
#548 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Shell
Stars
3.2k
Forks
863
Avg merge
3h 15m
Merged PRs (30d)
2

Description

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

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

In install.sh, start at the distribution detection logic and reproduce the reported curl command on TencentOS Server V4.4. Confirm that ID=tencentos reaches the CentOS/RHEL-compatible installation path and that Docker CE installation completes; done means the convenience script recognizes TencentOS and installs Docker successfully.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, shell
Domain
devops, infrastructure
Issue type
Feature
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.