From bab3106d3bc335ab95c01ff253823785bf1eecca Mon Sep 17 00:00:00 2001 From: TheSpad Date: Tue, 3 Oct 2023 19:08:11 +0100 Subject: [PATCH 1/5] Add support policy --- docs/general/.pages | 1 + docs/general/support-policy.md | 56 ++++++++++++++++++++++++++++++++++ 2 files changed, 57 insertions(+) create mode 100644 docs/general/support-policy.md diff --git a/docs/general/.pages b/docs/general/.pages index d88d4486c8..1ce8f0a81f 100644 --- a/docs/general/.pages +++ b/docs/general/.pages @@ -4,6 +4,7 @@ nav: - running-our-containers.md - container-customization.md - docker-compose.md + - support-policy.md - understanding-puid-and-pgid.md - updating-our-containers.md - volumes.md diff --git a/docs/general/support-policy.md b/docs/general/support-policy.md new file mode 100644 index 0000000000..815067ec2b --- /dev/null +++ b/docs/general/support-policy.md @@ -0,0 +1,56 @@ +# Linuxserver Support Policy + +Any exceptions to this support policy will be clearly called out in the readme for the relevant image. + +## Formally Supported Images + +Any actively maintained image from the Linuxserver organisation, excluding base images, is in scope for support. Note that if you are running an old version of an image we will likely ask you to upgrade to the latest version before providing support, unless your issue is version-specific. + +This means that images, tags, and architectures that have been deprecated or archived are not in scope. + +## Formally Supported Environments + +We build and test all of our images using the latest stable branch of Docker CE using containerd.io and runc, on Linux, building for x86_64 (amd64) and aarch64 (arm64) architectures. Any matching client environment is in scope for support. In addition, any currently supported version of Docker is in scope. + +We support the use of both docker compose and the docker CLI to manage containers, though the former is preferred. + +We support the running of our containers on Unraid, using our supplied templates. We will not provide support for Unraid itself. + +## Docker Mods + +Support for the underlying mod logic is within scope for support, however, support for the mods themselves is provided by the listed maintainer of that mod, whether it is published in our mods repo or elsewhere. + +## Reasonable Endeavours Support + +There are many alternative configurations that should broadly work for most of our images, but we make no guarantees to that effect, and expect that you have a solid understanding of the underlying technologies you're using. Although we do not formally support them, we will provide help where we can with any of the following: + +* Use of our base images for 3rd party projects +* Use of our images with alternative container runtimes +* Use of locally built versions of our images +* Docker Desktop on Windows, Mac, or Linux +* Rootless Docker +* Docker in Docker +* Docker Swarm +* EOL versions of Docker (where there is no option to upgrade) +* Podman (Rootless or Rootful) +* Routing container traffic through a VPN + +## Unsupported + +The following configurations are entirely unsupported and we will not provide help with them, even if you have been able to get them to work: + +* Any of our images which have been deprecated or archived +* Any forks of our images maintained by 3rd parties +* Use of 3rd party management tools, such as Portainer, to create or update containers +* Use of automated container update tools, such as Watchtower +* Use of remote file storage, such as SMB or NFS, for container `/config` mounts +* Use of LXC containers +* Use of k8s or k3s + +## Unsupported and Known To Be Broken + +The following configurations are entirely unsupported and you are unlikely to be able to get them to work at all, or experience serious issues if you do: + +* Use of the `user` directive to run containers as a custom UID/GID +* Use of a custom `init` for Docker +* Overriding container entrypoints From 8ee07a02537a56ee88701e56f755a7614d7d79f2 Mon Sep 17 00:00:00 2001 From: TheSpad Date: Tue, 3 Oct 2023 19:13:59 +0100 Subject: [PATCH 2/5] Small typo fixes --- docs/general/support-policy.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/general/support-policy.md b/docs/general/support-policy.md index 815067ec2b..c86f921d61 100644 --- a/docs/general/support-policy.md +++ b/docs/general/support-policy.md @@ -10,7 +10,7 @@ This means that images, tags, and architectures that have been deprecated or arc ## Formally Supported Environments -We build and test all of our images using the latest stable branch of Docker CE using containerd.io and runc, on Linux, building for x86_64 (amd64) and aarch64 (arm64) architectures. Any matching client environment is in scope for support. In addition, any currently supported version of Docker is in scope. +We build and test all of our images using the latest stable branch of Docker CE using containerd and runc, on Linux, building for x86_64 (amd64) and aarch64 (arm64) architectures. Any matching client environment is in scope for support. In addition, any currently supported version of Docker is in scope. We support the use of both docker compose and the docker CLI to manage containers, though the former is preferred. @@ -22,7 +22,7 @@ Support for the underlying mod logic is within scope for support, however, suppo ## Reasonable Endeavours Support -There are many alternative configurations that should broadly work for most of our images, but we make no guarantees to that effect, and expect that you have a solid understanding of the underlying technologies you're using. Although we do not formally support them, we will provide help where we can with any of the following: +There are many alternative configurations that should broadly work for most of our images, but we make no guarantees to that effect, and expect that you have a solid understanding of the underlying technologies you're using. Although we do not formally support them, we will endeavour to provide help where we can with any of the following: * Use of our base images for 3rd party projects * Use of our images with alternative container runtimes From d08ba2de5457f9bb9751b3bfa79a0c4d3b6bcee6 Mon Sep 17 00:00:00 2001 From: TheSpad Date: Tue, 3 Oct 2023 19:18:02 +0100 Subject: [PATCH 3/5] Add change history --- docs/general/support-policy.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/general/support-policy.md b/docs/general/support-policy.md index c86f921d61..884987372b 100644 --- a/docs/general/support-policy.md +++ b/docs/general/support-policy.md @@ -10,7 +10,7 @@ This means that images, tags, and architectures that have been deprecated or arc ## Formally Supported Environments -We build and test all of our images using the latest stable branch of Docker CE using containerd and runc, on Linux, building for x86_64 (amd64) and aarch64 (arm64) architectures. Any matching client environment is in scope for support. In addition, any currently supported version of Docker is in scope. +We build and test all of our images using the latest stable branch of Docker CE using containerd and runc, on Linux, building for x86_64 (amd64) and aarch64 (arm64) architectures. Any matching client environment is in scope for support. In addition, any currently supported version of Docker CE is in scope. We support the use of both docker compose and the docker CLI to manage containers, though the former is preferred. @@ -54,3 +54,7 @@ The following configurations are entirely unsupported and you are unlikely to be * Use of the `user` directive to run containers as a custom UID/GID * Use of a custom `init` for Docker * Overriding container entrypoints + +## Change History + +* 2023-10-03 - Initial release From eba9bcc21b02defb16a2cec0e3ab5e8c6db78796 Mon Sep 17 00:00:00 2001 From: TheSpad Date: Wed, 4 Oct 2023 22:54:35 +0100 Subject: [PATCH 4/5] Add 3rd party guides --- docs/general/support-policy.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/general/support-policy.md b/docs/general/support-policy.md index 884987372b..62fd359d51 100644 --- a/docs/general/support-policy.md +++ b/docs/general/support-policy.md @@ -1,10 +1,10 @@ -# Linuxserver Support Policy +# LinuxServer Support Policy Any exceptions to this support policy will be clearly called out in the readme for the relevant image. ## Formally Supported Images -Any actively maintained image from the Linuxserver organisation, excluding base images, is in scope for support. Note that if you are running an old version of an image we will likely ask you to upgrade to the latest version before providing support, unless your issue is version-specific. +Any actively maintained image from the LinuxServer organisation, excluding base images, is in scope for support. Note that if you are running an old version of an image we will likely ask you to upgrade to the latest version before providing support, unless your issue is version-specific. This means that images, tags, and architectures that have been deprecated or archived are not in scope. @@ -41,6 +41,7 @@ The following configurations are entirely unsupported and we will not provide he * Any of our images which have been deprecated or archived * Any forks of our images maintained by 3rd parties +* Use of 3rd party guides or tutorials for configuring our images * Use of 3rd party management tools, such as Portainer, to create or update containers * Use of automated container update tools, such as Watchtower * Use of remote file storage, such as SMB or NFS, for container `/config` mounts From bb7019c40e36ee9f9c9db7c0af3f11c9b3ab5bbf Mon Sep 17 00:00:00 2001 From: TheSpad Date: Wed, 11 Oct 2023 22:35:03 +0100 Subject: [PATCH 5/5] Add repo/snap installs of docker --- docs/general/support-policy.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/general/support-policy.md b/docs/general/support-policy.md index 62fd359d51..a8b610f13c 100644 --- a/docs/general/support-policy.md +++ b/docs/general/support-policy.md @@ -31,6 +31,8 @@ There are many alternative configurations that should broadly work for most of o * Rootless Docker * Docker in Docker * Docker Swarm +* Docker installed from distro repos (use the [official repos](https://docs.docker.com/engine/install/) instead) +* Docker installed via Snap (use the [official repos](https://docs.docker.com/engine/install/) instead) * EOL versions of Docker (where there is no option to upgrade) * Podman (Rootless or Rootful) * Routing container traffic through a VPN