]> git.proxmox.com Git - pve-docs.git/blobdiff - pct.adoc
attrs: update cephdocs template to quincy
[pve-docs.git] / pct.adoc
index 7cfae3241b5582037afdcb2b9850f93b7f87399f..fdeb6dd17f9661f7ca2e7f25fb37a67508a7fde2 100644 (file)
--- a/pct.adoc
+++ b/pct.adoc
@@ -59,7 +59,7 @@ VM, but without the additional overhead. This means that Proxmox Containers can
 be categorized as ``System Containers'', rather than ``Application Containers''.
 
 NOTE: If you want to run application containers, for example, 'Docker' images, it
-is recommended that you run them inside a Proxmox Qemu VM. This will give you
+is recommended that you run them inside a Proxmox QEMU VM. This will give you
 all the advantages of application containerization, while also providing the
 benefits that VMs offer, such as strong isolation from the host and the ability
 to live-migrate, which otherwise isn't possible with containers. 
@@ -106,20 +106,25 @@ Alpine Linux
 
 [quote, 'https://alpinelinux.org']
 ____
-"Alpine Linux is a security-oriented, lightweight Linux distribution based on
-musl libc and busybox."
+Alpine Linux is a security-oriented, lightweight Linux distribution based on
+musl libc and busybox.
 ____
 
+For currently supported releases see:
+
 https://alpinelinux.org/releases/
 
 Arch Linux
 ~~~~~~~~~~
 
-[quote, 'https://wiki.archlinux.org/title/Arch_Linux']
+[quote, 'https://archlinux.org/']
 ____
-"a lightweight and flexible Linux® distribution that tries to Keep It Simple."
+Arch Linux, a lightweight and flexible Linux® distribution that tries to Keep It Simple.
 ____
 
+Arch Linux is using a rolling-release model, see its wiki for more details:
+
+https://wiki.archlinux.org/title/Arch_Linux
 
 CentOS, Almalinux, Rocky Linux
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -129,11 +134,13 @@ CentOS / CentOS Stream
 
 [quote, 'https://centos.org']
 ____
-"The CentOS Linux distribution is a stable, predictable, manageable and
+The CentOS Linux distribution is a stable, predictable, manageable and
 reproducible platform derived from the sources of Red Hat Enterprise Linux
-(RHEL)"
+(RHEL)
 ____
 
+For currently supported releases see:
+
 https://wiki.centos.org/About/Product
 
 Almalinux
@@ -141,13 +148,15 @@ 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."
+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.
 ____
 
 
+For currently supported releases see:
+
 https://en.wikipedia.org/wiki/AlmaLinux#Releases
 
 Rocky Linux
@@ -155,11 +164,13 @@ 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."
+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.
 ____
 
+For currently supported releases see:
+
 https://en.wikipedia.org/wiki/Rocky_Linux#Releases
 
 Debian
@@ -167,11 +178,13 @@ Debian
 
 [quote, 'https://www.debian.org/intro/index#software']
 ____
-"Debian is a free operating system, developed and maintained by the 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."
+users' needs.
 ____
 
+For currently supported releases see:
+
 https://www.debian.org/releases/stable/releasenotes
 
 Devuan
@@ -179,22 +192,27 @@ Devuan
 
 [quote, 'https://www.devuan.org']
 ____
-"Devuan GNU+Linux is a fork of Debian without systemd that allows users to
+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."
+ensuring Init Freedom.
 ____
 
+For currently supported releases see:
+
+https://www.devuan.org/os/releases
 
 Fedora
 ~~~~~~
 
 [quote, 'https://getfedora.org']
 ____
-"Fedora creates an innovative, free, and open source platform for hardware,
+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."
+to build tailored solutions for their users.
 ____
 
+For currently supported releases see:
+
 https://fedoraproject.org/wiki/Releases
 
 Gentoo
@@ -202,27 +220,34 @@ Gentoo
 
 [quote, 'https://www.gentoo.org']
 ____
-"a highly flexible, source-based Linux distribution."
+a highly flexible, source-based Linux distribution.
 ____
 
+Gentoo is using a rolling-release model.
+
 OpenSUSE
 ~~~~~~~~
 
 [quote, 'https://www.opensuse.org']
 ____
-"The makers' choice for sysadmins, developers and desktop users."
+The makers' choice for sysadmins, developers and desktop users.
 ____
 
+For currently supported releases see:
+
 https://get.opensuse.org/leap/
 
 Ubuntu
 ~~~~~~
 
-[quote, 'https://docs.ubuntu.com/']
+[quote, 'https://ubuntu.com/']
 ____
-"The world’s most popular Linux for desktop computing."
+Ubuntu is the modern, open source operating system on Linux for the enterprise
+server, desktop, cloud, and IoT.
 ____
 
+For currently supported releases see:
+
 https://wiki.ubuntu.com/Releases
 
 [[pct_container_images]]
@@ -402,8 +427,9 @@ cpulimit: 0.5
 
 `cpuunits`: :: This is a relative weight passed to the kernel scheduler. The
 larger the number is, the more CPU time this container gets. Number is relative
-to the weights of all the other running containers. The default is 1024. You
-can use this setting to prioritize some containers.
+to the weights of all the other running containers. The default is `100` (or
+`1024` if the host uses legacy cgroup v1). You can use this setting to
+prioritize some containers.
 
 
 [[pct_memory]]
@@ -496,10 +522,21 @@ hierarchy under `/mnt/bindmounts`. Never bind mount system directories like
 NOTE: The bind mount source path must not contain any symlinks.
 
 For example, to make the directory `/mnt/bindmounts/shared` accessible in the
-container with ID `100` under the path `/shared`, use a configuration line like
-`mp0: /mnt/bindmounts/shared,mp=/shared` in `/etc/pve/lxc/100.conf`.
-Alternatively, use `pct set 100 -mp0 /mnt/bindmounts/shared,mp=/shared` to
-achieve the same result.
+container with ID `100` under the path `/shared`, add a configuration line such as:
+
+----
+mp0: /mnt/bindmounts/shared,mp=/shared
+----
+
+into `/etc/pve/lxc/100.conf`.
+
+Or alternatively use the `pct` tool:
+
+----
+pct set 100 -mp0 /mnt/bindmounts/shared,mp=/shared
+----
+
+to achieve the same result.
 
 
 Device Mount Points
@@ -1025,6 +1062,19 @@ backup jobs and HA resource configurations.
 # pct destroy 100 --purge
 ----
 
+Move a mount point volume to a different storage.
+
+----
+# pct move-volume 100 mp0 other-storage
+----
+
+Reassign a volume to a different CT. This will remove the volume `mp0` from
+the source CT and attaches it as `mp1` to the target CT. In the background
+the volume is being renamed so that the name matches the new owner.
+
+----
+#  pct move-volume 100 mp0 --target-vmid 200 --target-volume mp1
+----
 
 
 Obtaining Debugging Logs