From 87d7cda247e070af27c05ce2e427351cf97446d9 Mon Sep 17 00:00:00 2001 From: saltydk Date: Wed, 1 Jan 2025 04:47:42 +0100 Subject: [PATCH] clean up 20.04 references as it is no longer supported for new installs --- docs/reference/guides/chazguides/home-server.md | 2 +- docs/reference/guides/cloudbox.md | 6 +++--- docs/reference/saltbox-vs-cloudbox.md | 2 +- docs/reference/server.md | 4 ++-- docs/saltbox/basics/basics.md | 2 +- docs/saltbox/prerequisites/prerequisites.md | 4 ++-- 6 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/reference/guides/chazguides/home-server.md b/docs/reference/guides/chazguides/home-server.md index ad5d9a0c1..4e7d9e925 100644 --- a/docs/reference/guides/chazguides/home-server.md +++ b/docs/reference/guides/chazguides/home-server.md @@ -163,7 +163,7 @@ From this point on there is nothing special about the install process on this ho This is just an example of the install. You should refer to the actual [install docs](../../../saltbox/install/install.md). -I installed Ubuntu server 20.04 on the machine, accepting all defaults except: +I installed Ubuntu server 24.04 on the machine, accepting all defaults except: - I enabled OpenSSH and imported my SSH keys from github diff --git a/docs/reference/guides/cloudbox.md b/docs/reference/guides/cloudbox.md index 9216bf889..a930cfe9c 100644 --- a/docs/reference/guides/cloudbox.md +++ b/docs/reference/guides/cloudbox.md @@ -2,7 +2,7 @@ Saltbox is a continuation of the Cloudbox project and is mostly compatible out of the box. Very little has to be done to bring your old Cloudbox data into Saltbox. Any customisations you have made or special roles are going to require extra work as Saltbox uses Traefik instead of nginx. -IMPORTANT: Migration has the same requirements as a new install; Saltbox still expects a clean install of the OS; this means that you *cannot* upgrade an existing Cloudbox setup to Saltbox *in place*. You will have to back up, reinstall the OS fresh on the machine, then start the migration. Do not upgrade your Ubuntu 18.04 Cloudbox machine to Ubuntu 20.04 or higher and try to run this migration. It won't work. +IMPORTANT: Migration has the same requirements as a new install; Saltbox still expects a clean install of the OS; this means that you *cannot* upgrade an existing Cloudbox setup to Saltbox *in place*. You will have to back up, reinstall the OS fresh on the machine, then start the migration. Do not upgrade your Ubuntu 18.04 Cloudbox machine to Ubuntu 22.04 or higher and try to run this migration. It won't work. ## Before Migration @@ -96,9 +96,9 @@ Backup from Cloudbox as you normally would. You will need to make the backup dri ## Migration -IMPORTANT: Migration has the same requirements as a new install; Saltbox still expects a clean install of the OS; this means that you *cannot* upgrade an existing Cloudbox setup to Saltbox *in place*. You will have to back up, reinstall the OS fresh on the machine, then start the migration. Do not upgrade your Ubuntu 18.04 Cloudbox machine to Ubuntu 20.04 and try to run this migration. It won't work. +IMPORTANT: Migration has the same requirements as a new install; Saltbox still expects a clean install of the OS; this means that you *cannot* upgrade an existing Cloudbox setup to Saltbox *in place*. You will have to back up, reinstall the OS fresh on the machine, then start the migration. Do not upgrade your Ubuntu 18.04 Cloudbox machine to Ubuntu 20.04+ and try to run this migration. It won't work. -Do not proceed unless the machine you're using is a fresh install of Ubuntu 20.04 or 22.04. +Do not proceed unless the machine you're using is a fresh install of Ubuntu 22.04 or 24.04. - Install the saltbox dependencies diff --git a/docs/reference/saltbox-vs-cloudbox.md b/docs/reference/saltbox-vs-cloudbox.md index 110db6639..d919daf1f 100644 --- a/docs/reference/saltbox-vs-cloudbox.md +++ b/docs/reference/saltbox-vs-cloudbox.md @@ -15,7 +15,7 @@ There isn't a maintained list of differences as the improvements have happened s In terms of functionality the high points are -- Validated Ubuntu 20.04, 22.04, and 24.04 support (Saltbox will try to support newer releases quicker than Cloudbox has) which is useful in terms of hardware acceleration support with newer CPUs. +- Validated Ubuntu 22.04, and 24.04 support (Saltbox will try to support newer releases quicker than Cloudbox has) which is useful in terms of hardware acceleration support with newer CPUs. - Support for IPv6 within the docker container network using NAT since we still want to keep things behind the reverse proxy. - Inventory system for simpler, upgrade-protected customization - Authelia single sign-on diff --git a/docs/reference/server.md b/docs/reference/server.md index 53ec264c8..60ff3c454 100644 --- a/docs/reference/server.md +++ b/docs/reference/server.md @@ -12,7 +12,7 @@ tags: About the requirements: -You will need a dedicated server freshly installed with Ubuntu Server [20.04](https://releases.ubuntu.com/20.04/), [22.04](https://releases.ubuntu.com/22.04/), or [24.04](https://releases.ubuntu.com/24.04/). +You will need a dedicated server freshly installed with Ubuntu Server [22.04](https://releases.ubuntu.com/22.04/), or [24.04](https://releases.ubuntu.com/24.04/). This server can be either local to you or rented froma server provider. @@ -24,7 +24,7 @@ When you install Ubuntu on the server, do not preinstall anything other than Ope The install assumes that this is a fresh setup without anything else installed. If your server has things like Docker preinstalled, chances are the installer will fail with a non-obvious error, or other problems will show up later. -In other words, you should not upgrade your Ubuntu 18.04 machine running Cloudbox to Ubuntu 20.04 and then install Saltbox on top of it. You should wipe the machine, install 20.04 or 22.04 fresh and start there. +In other words, you should not upgrade your Ubuntu 18.04 machine running Cloudbox to Ubuntu 22.04 and then install Saltbox on top of it. You should wipe the machine, install 22.04 or 24.04 fresh and start there. Typically this server is remote to you; you can install on a home server, keeping in mind some [home server considerations](#home-server-considerations) diff --git a/docs/saltbox/basics/basics.md b/docs/saltbox/basics/basics.md index f24fbb5f2..acffcc646 100644 --- a/docs/saltbox/basics/basics.md +++ b/docs/saltbox/basics/basics.md @@ -13,7 +13,7 @@ tags: ## What is Saltbox? -- [Saltbox](https://github.com/saltyorg/Saltbox) is an [Ansible](https://www.ansible.com/how-ansible-works) and [Docker](https://www.docker.com/what-container) based solution for rapidly deploying a cloud media server using LTS releases of Ubuntu Server 20.04, 22.04 or 24.04, running on AMD64. Non-LTS releases of Ubuntu or Desktop installs are not supported. Linux distributions other than Ubuntu are not supported. ARM processors, Raspberry Pi notably, are not supported. +- [Saltbox](https://github.com/saltyorg/Saltbox) is an [Ansible](https://www.ansible.com/how-ansible-works) and [Docker](https://www.docker.com/what-container) based solution for rapidly deploying a cloud media server using LTS releases of Ubuntu Server 22.04 or 24.04, running on AMD64. Non-LTS releases of Ubuntu or Desktop installs are not supported. Linux distributions other than Ubuntu are not supported. ARM processors, Raspberry Pi notably, are not supported. - Primary functions are: the automatic acquisition of media, being able to play it back from anywhere and from any device, and to a lesser extent storing that media on the cloud. diff --git a/docs/saltbox/prerequisites/prerequisites.md b/docs/saltbox/prerequisites/prerequisites.md index d4c78459a..33ef33fa9 100644 --- a/docs/saltbox/prerequisites/prerequisites.md +++ b/docs/saltbox/prerequisites/prerequisites.md @@ -36,7 +36,7 @@ There are, broadly, 4 prerequisites to installing Saltbox: ### Operating Systems -At this time, we only support LTS releases of Ubuntu Server [20.04](https://releases.ubuntu.com/20.04/), [22.04](https://releases.ubuntu.com/22.04/), or [24.04](https://releases.ubuntu.com/24.04/), freshly installed. +At this time, we only support LTS releases of Ubuntu Server [22.04](https://releases.ubuntu.com/22.04/), or [24.04](https://releases.ubuntu.com/24.04/), freshly installed. !!! warning Desktop editions are excluded. While Saltbox may technically run alongside a desktop environment, we will decline all forms of support around this use case. @@ -47,7 +47,7 @@ For best results, the assumed server environment for Saltbox is: - a dedicated remote server [not a VPS or a virtualized setup like proxmox] [see below for important information about Hetzner], - with a processor compliant with the `x86_64`/`amd64` [`arm` NOT SUPPORTED] architecture, -- running a brand new fresh install of the server version of Ubuntu 20.04, 22.04, or 24.04, +- running a brand new fresh install of the server version of Ubuntu 22.04, or 24.04, - from a server provider like Hetzner, OVH, kimsufi, etc., - nothing else [docker, for example] preinstalled, - with at least 500GB of disk space, and