From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by lists.proxmox.com (Postfix) with ESMTPS id 399F875987 for ; Thu, 14 Oct 2021 10:19:23 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id 3758D1A73D for ; Thu, 14 Oct 2021 10:19:23 +0200 (CEST) Received: from proxmox-new.maurer-it.com (proxmox-new.maurer-it.com [94.136.29.106]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by firstgate.proxmox.com (Proxmox) with ESMTPS id 2898F1A732 for ; Thu, 14 Oct 2021 10:19:22 +0200 (CEST) Received: from proxmox-new.maurer-it.com (localhost.localdomain [127.0.0.1]) by proxmox-new.maurer-it.com (Proxmox) with ESMTP id 0176344338 for ; Thu, 14 Oct 2021 10:19:22 +0200 (CEST) From: Oguz Bektas To: pve-devel@lists.proxmox.com Date: Thu, 14 Oct 2021 10:19:16 +0200 Message-Id: <20211014081916.575700-1-o.bektas@proxmox.com> X-Mailer: git-send-email 2.30.2 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-SPAM-LEVEL: Spam detection results: 0 AWL 0.948 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record Subject: [pve-devel] [PATCH v2 docs] pct: add section for supported distributions X-BeenThere: pve-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox VE development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 14 Oct 2021 08:19:23 -0000 adds a simple section with a list of officially supported distributions Signed-off-by: Oguz Bektas --- v1->v2: * removed list of releases, instead put link to releases page for distro (if it exists) * added simple descriptions from respective websites of distros * put centos and derivatives into single heading pct.adoc | 125 ++++++++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 119 insertions(+), 6 deletions(-) diff --git a/pct.adoc b/pct.adoc index d01e6d7..b504249 100644 --- a/pct.adoc +++ b/pct.adoc @@ -84,13 +84,126 @@ Technology Overview * Modern Linux kernels -* Image based deployment (templates) +* Image based deployment (xref:pct_supported_distributions[templates]) * Uses {pve} xref:chapter_storage[storage library] * Container setup from host (network, DNS, storage, etc.) +[[pct_supported_distributions]] +Supported Distributions +~~~~~~~~~~~~~~~~~~~~~~~ + +List of officially supported distributions can be found below. + +Templates for the following distributions are available through our +repositories. You can use xref:pct_container_images[pveam] tool or the +Graphical User Interface to download them. + +Alpine Linux +^^^^^^^^^^^^ + +"Alpine Linux is a security-oriented, lightweight Linux distribution based on +musl libc and busybox." + +https://alpinelinux.org + +https://alpinelinux.org/releases/ + +Archlinux +^^^^^^^^^ + +"a lightweight and flexible Linux® distribution that tries to Keep It Simple." + +https://wiki.archlinux.org/title/Arch_Linux + + +CentOS, Almalinux, Rocky Linux +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +__CentOS__: "The CentOS Linux distribution is a stable, predictable, manageable and +reproducible platform derived from the sources of Red Hat Enterprise Linux +(RHEL)" + +https://centos.org + +https://wiki.centos.org/About/Product + +__Almalinux__: "An Open Source, community owned and governed, forever-free +enterprise Linux distribution, focused on long-term stability, providing a +robust production-grade platform. AlmaLinux OS is 1:1 binary compatible with +RHEL® and pre-Stream CentOS." + +https://almalinux.org + +https://en.wikipedia.org/wiki/AlmaLinux#Releases + +__Rocky Linux__: "Rocky Linux is a community enterprise operating system designed +to be 100% bug-for-bug compatible with America's top enterprise Linux +distribution now that its downstream partner has shifted direction." + +https://rockylinux.org/ + +https://en.wikipedia.org/wiki/Rocky_Linux#Releases + + +Debian +^^^^^^ + +"Debian is a free operating system, developed and maintained by the Debian +project. A free Linux distribution with thousands of applications to meet our +users' needs." + +https://www.debian.org/intro/index#software + +https://www.debian.org/releases/stable/releasenotes + +Devuan +^^^^^^ + +"Devuan GNU+Linux is a fork of Debian without systemd that allows users to +reclaim control over their system by avoiding unnecessary entanglements and +ensuring Init Freedom." + +https://www.devuan.org + +Fedora +^^^^^^ + +"Fedora creates an innovative, free, and open source platform for hardware, +clouds, and containers that enables software developers and community members +to build tailored solutions for their users." + +https://getfedora.org + +https://fedoraproject.org/wiki/Releases + +Gentoo +^^^^^^ + +"a highly flexible, source-based Linux distribution." + +https://www.gentoo.org + +OpenSUSE +^^^^^^^^ + +"The makers' choice for sysadmins, developers and desktop users." + +https://www.opensuse.org + +https://get.opensuse.org/leap/ + +Ubuntu +^^^^^^ + +"The world’s most popular Linux for desktop computing." + +https://docs.ubuntu.com/ + +https://wiki.ubuntu.com/Releases + [[pct_container_images]] Container Images ---------------- @@ -98,11 +211,11 @@ Container Images Container images, sometimes also referred to as ``templates'' or ``appliances'', are `tar` archives which contain everything to run a container. -{pve} itself provides a variety of basic templates for the most common Linux -distributions. They can be downloaded using the GUI or the `pveam` (short for -{pve} Appliance Manager) command line utility. -Additionally, https://www.turnkeylinux.org/[TurnKey Linux] container templates -are also available to download. +{pve} itself provides a variety of basic templates for the +xref:pct_supported_distributions[most common Linux distributions]. They can be +downloaded using the GUI or the `pveam` (short for {pve} Appliance Manager) +command line utility. Additionally, https://www.turnkeylinux.org/[TurnKey +Linux] container templates are also available to download. The list of available templates is updated daily through the 'pve-daily-update' timer. You can also trigger an update manually by executing: -- 2.30.2