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) server-digest SHA256) (No client certificate requested) by lists.proxmox.com (Postfix) with ESMTPS id 7679E7C2AF for ; Thu, 4 Nov 2021 13:06:36 +0100 (CET) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id 606DD20263 for ; Thu, 4 Nov 2021 13:06:06 +0100 (CET) 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)) (No client certificate requested) by firstgate.proxmox.com (Proxmox) with ESMTPS id 9E8E120257 for ; Thu, 4 Nov 2021 13:06:02 +0100 (CET) Received: from proxmox-new.maurer-it.com (localhost.localdomain [127.0.0.1]) by proxmox-new.maurer-it.com (Proxmox) with ESMTP id 6CC77469DF for ; Thu, 4 Nov 2021 13:06:02 +0100 (CET) From: Oguz Bektas To: pve-devel@lists.proxmox.com Date: Thu, 4 Nov 2021 13:05:56 +0100 Message-Id: <20211104120556.744712-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.860 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 URIBL_BLOCKED 0.001 ADMINISTRATOR NOTICE: The query to URIBL was blocked. See http://wiki.apache.org/spamassassin/DnsBlocklists#dnsbl-block for more information. [ubuntu.com, fedoraproject.org, devuan.org, alpinelinux.org, rockylinux.org, turnkeylinux.org, getfedora.org, archlinux.org, wikipedia.org, almalinux.org] Subject: [pve-devel] [PATCH v3 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, 04 Nov 2021 12:06:36 -0000 Signed-off-by: Oguz Bektas --- v2->v3: * use asciidoc quote syntax * using single quotes makes the link clickable inside quote pct.adoc | 144 ++++++++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 138 insertions(+), 6 deletions(-) diff --git a/pct.adoc b/pct.adoc index d01e6d7..d42a936 100644 --- a/pct.adoc +++ b/pct.adoc @@ -84,13 +84,145 @@ 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 +^^^^^^^^^^^^ + +[quote, 'https://alpinelinux.org'] +____ +"Alpine Linux is a security-oriented, lightweight Linux distribution based on +musl libc and busybox." +____ + +https://alpinelinux.org/releases/ + +Archlinux +^^^^^^^^^ + +[quote, 'https://wiki.archlinux.org/title/Arch_Linux'] +____ +"a lightweight and flexible Linux® distribution that tries to Keep It Simple." +____ + + +CentOS, Almalinux, Rocky Linux +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +__CentOS__: + +[quote, 'https://centos.org'] +____ +"The CentOS Linux distribution is a stable, predictable, manageable and +reproducible platform derived from the sources of Red Hat Enterprise Linux +(RHEL)" +____ + +https://wiki.centos.org/About/Product + +__Almalinux__: + +[quote, 'https://almalinux.org'] +____ +"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://en.wikipedia.org/wiki/AlmaLinux#Releases + +__Rocky Linux__: + +[quote, 'https://rockylinux.org'] +____ +"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://en.wikipedia.org/wiki/Rocky_Linux#Releases + + +Debian +^^^^^^ + +[quote, 'https://www.debian.org/intro/index#software'] +____ +"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/releases/stable/releasenotes + +Devuan +^^^^^^ + +[quote, 'https://www.devuan.org'] +____ +"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." +____ + + +Fedora +^^^^^^ + +[quote, 'https://getfedora.org'] +____ +"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://fedoraproject.org/wiki/Releases + +Gentoo +^^^^^^ + +[quote, 'https://www.gentoo.org'] +____ +"a highly flexible, source-based Linux distribution." +____ + +OpenSUSE +^^^^^^^^ + +[quote, 'https://www.opensuse.org'] +____ +"The makers' choice for sysadmins, developers and desktop users." +____ + +https://get.opensuse.org/leap/ + +Ubuntu +^^^^^^ + +[quote, 'https://docs.ubuntu.com/'] +____ +"The world’s most popular Linux for desktop computing." +____ + +https://wiki.ubuntu.com/Releases + [[pct_container_images]] Container Images ---------------- @@ -98,11 +230,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