mirror of
https://github.com/Cog-Creators/Red-DiscordBot.git
synced 2025-11-06 03:08:55 -05:00
Update install guides with new OS support matrix (#6309)
This commit is contained in:
Jakub Kuczys
GitHub
parent
edfb9ffe62
commit
a30f9ff7e6
@ -1,27 +0,0 @@
|
|||||||
----------------------------
|
|
||||||
Installing Python with pyenv
|
|
||||||
----------------------------
|
|
||||||
|
|
||||||
On distributions where Python 3.10 needs to be compiled from source, we recommend the use of pyenv.
|
|
||||||
This simplifies the compilation process and has the added bonus of simplifying setting up Red in a
|
|
||||||
virtual environment.
|
|
||||||
|
|
||||||
.. include:: _includes/_install-pyenv-and-setup-path.rst
|
|
||||||
|
|
||||||
.. prompt:: bash
|
|
||||||
|
|
||||||
CONFIGURE_OPTS=--enable-optimizations pyenv install 3.10.13 -v
|
|
||||||
|
|
||||||
This may take a long time to complete, depending on your hardware. For some machines (such as
|
|
||||||
Raspberry Pis and micro-tier VPSes), it may take over an hour; in this case, you may wish to remove
|
|
||||||
the ``CONFIGURE_OPTS=--enable-optimizations`` part from the front of the command, which will
|
|
||||||
drastically reduce the install time. However, be aware that this will make Python run about 10%
|
|
||||||
slower.
|
|
||||||
|
|
||||||
After that is finished, run:
|
|
||||||
|
|
||||||
.. prompt:: bash
|
|
||||||
|
|
||||||
pyenv global 3.10.13
|
|
||||||
|
|
||||||
Pyenv is now installed and your system should be configured to run Python 3.10.
|
|
||||||
@ -18,20 +18,20 @@ Install the pre-requirements with pacman:
|
|||||||
|
|
||||||
sudo pacman -Syu git jre17-openjdk-headless base-devel nano
|
sudo pacman -Syu git jre17-openjdk-headless base-devel nano
|
||||||
|
|
||||||
On Arch Linux, Python 3.9 can be installed from the Arch User Repository (AUR) from the ``python39`` package.
|
On Arch Linux, Python 3.10 can be installed from the Arch User Repository (AUR) from the ``python310`` package.
|
||||||
|
|
||||||
The manual build process is the Arch-supported install method for AUR packages. You can install ``python39`` package with the following commands:
|
The manual build process is the Arch-supported install method for AUR packages. You can install ``python310`` package with the following commands:
|
||||||
|
|
||||||
.. prompt:: bash
|
.. prompt:: bash
|
||||||
|
|
||||||
git clone https://aur.archlinux.org/python39.git /tmp/python39
|
git clone https://aur.archlinux.org/python310.git /tmp/python310
|
||||||
cd /tmp/python39
|
cd /tmp/python310
|
||||||
makepkg -sicL
|
makepkg -sicL
|
||||||
cd -
|
cd -
|
||||||
rm -rf /tmp/python39
|
rm -rf /tmp/python310
|
||||||
|
|
||||||
.. Include common instructions:
|
.. Include common instructions:
|
||||||
|
|
||||||
.. include:: _includes/create-env-with-venv3.9.rst
|
.. include:: _includes/create-env-with-venv3.10.rst
|
||||||
|
|
||||||
.. include:: _includes/install-and-setup-red-unix.rst
|
.. include:: _includes/install-and-setup-red-unix.rst
|
||||||
|
|||||||
@ -12,7 +12,7 @@ Installing Red on Fedora Linux
|
|||||||
Installing the pre-requirements
|
Installing the pre-requirements
|
||||||
-------------------------------
|
-------------------------------
|
||||||
|
|
||||||
Fedora Linux 37 and above has all required packages available in official repositories. Install
|
Fedora Linux 38 and above has all required packages available in official repositories. Install
|
||||||
them with dnf:
|
them with dnf:
|
||||||
|
|
||||||
.. prompt:: bash
|
.. prompt:: bash
|
||||||
|
|||||||
@ -26,8 +26,8 @@ we recommend **Ubuntu 22.04 LTS**.
|
|||||||
opensuse-tumbleweed
|
opensuse-tumbleweed
|
||||||
oracle-linux-8
|
oracle-linux-8
|
||||||
oracle-linux-9
|
oracle-linux-9
|
||||||
raspberry-pi-os-10
|
|
||||||
raspberry-pi-os-11
|
raspberry-pi-os-11
|
||||||
|
raspberry-pi-os-12
|
||||||
rhel-8
|
rhel-8
|
||||||
rhel-9
|
rhel-9
|
||||||
rocky-linux-8
|
rocky-linux-8
|
||||||
|
|||||||
@ -1,7 +1,7 @@
|
|||||||
.. _install-opensuse-leap-15:
|
.. _install-opensuse-leap-15:
|
||||||
|
|
||||||
=====================================
|
=====================================
|
||||||
Installing Red on openSUSE Leap 15.4+
|
Installing Red on openSUSE Leap 15.5+
|
||||||
=====================================
|
=====================================
|
||||||
|
|
||||||
.. include:: _includes/supported-arch-x64+aarch64.rst
|
.. include:: _includes/supported-arch-x64+aarch64.rst
|
||||||
@ -12,16 +12,16 @@ Installing Red on openSUSE Leap 15.4+
|
|||||||
Installing the pre-requirements
|
Installing the pre-requirements
|
||||||
-------------------------------
|
-------------------------------
|
||||||
|
|
||||||
openSUSE Leap 15.4+ has all required dependencies available in official repositories. Install them
|
openSUSE Leap 15.5+ has all required dependencies available in official repositories. Install them
|
||||||
with zypper:
|
with zypper:
|
||||||
|
|
||||||
.. prompt:: bash
|
.. prompt:: bash
|
||||||
|
|
||||||
sudo zypper -n install python310 python310-devel git-core java-17-openjdk-headless nano
|
sudo zypper -n install python311 python311-devel git-core java-17-openjdk-headless nano
|
||||||
sudo zypper -n install -t pattern devel_basis
|
sudo zypper -n install -t pattern devel_basis
|
||||||
|
|
||||||
.. Include common instructions:
|
.. Include common instructions:
|
||||||
|
|
||||||
.. include:: _includes/create-env-with-venv3.10.rst
|
.. include:: _includes/create-env-with-venv3.11.rst
|
||||||
|
|
||||||
.. include:: _includes/install-and-setup-red-unix.rst
|
.. include:: _includes/install-and-setup-red-unix.rst
|
||||||
|
|||||||
@ -1,55 +0,0 @@
|
|||||||
.. _install-raspberry-pi-os-10:
|
|
||||||
|
|
||||||
====================================================
|
|
||||||
Installing Red on Raspberry Pi OS (Legacy) 10 Buster
|
|
||||||
====================================================
|
|
||||||
|
|
||||||
.. include:: _includes/supported-arch-armv7l.rst
|
|
||||||
|
|
||||||
.. note::
|
|
||||||
|
|
||||||
While we do provide support and install instructions for running Red
|
|
||||||
on Raspberry Pi OS (Legacy) 10 Buster, we highly recommend installing/upgrading to
|
|
||||||
the new version - Raspberry Pi OS 11 Bullseye.
|
|
||||||
|
|
||||||
If you're not sure what version you are using,
|
|
||||||
you can check your version of Raspberry Pi OS by running:
|
|
||||||
|
|
||||||
.. prompt:: bash
|
|
||||||
|
|
||||||
lsb_release -a
|
|
||||||
|
|
||||||
If you're running Bullseye already, read `install-raspberry-pi-os-11` document instead.
|
|
||||||
|
|
||||||
If you're using Buster, please consider upgrading to Bullseye if possible.
|
|
||||||
You can read
|
|
||||||
`the post about Bullseye release from Raspberry Pi Foundation <https://www.raspberrypi.com/news/raspberry-pi-os-debian-bullseye/>`__
|
|
||||||
to learn how you can install/upgrade to the new version.
|
|
||||||
|
|
||||||
.. include:: _includes/linux-preamble.rst
|
|
||||||
|
|
||||||
-------------------------------
|
|
||||||
Installing the pre-requirements
|
|
||||||
-------------------------------
|
|
||||||
|
|
||||||
We recommend installing pyenv as a method of installing non-native versions of Python on
|
|
||||||
Raspberry Pi OS. This guide will tell you how. First, run the following commands:
|
|
||||||
|
|
||||||
.. cmake is necessary to be able to successfully build rapidfuzz.
|
|
||||||
|
|
||||||
.. prompt:: bash
|
|
||||||
|
|
||||||
sudo apt update
|
|
||||||
sudo apt -y install cmake make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev libgdbm-dev uuid-dev python3-openssl git openjdk-17-jre-headless nano
|
|
||||||
CXX=/usr/bin/g++
|
|
||||||
|
|
||||||
.. Include common instructions:
|
|
||||||
|
|
||||||
.. We should only build and install even versions of Python on Raspberry Pi OS as odd
|
|
||||||
.. versions are part of piwheels and can cause installs of pip packages that won't work.
|
|
||||||
|
|
||||||
.. include:: _includes/install-python310-pyenv.rst
|
|
||||||
|
|
||||||
.. include:: _includes/create-env-with-pyenv-virtualenv.rst
|
|
||||||
|
|
||||||
.. include:: _includes/install-and-setup-red-unix.rst
|
|
||||||
@ -1,25 +1,27 @@
|
|||||||
.. _install-raspberry-pi-os-11:
|
.. _install-raspberry-pi-os-11:
|
||||||
|
|
||||||
=============================================
|
======================================================
|
||||||
Installing Red on Raspberry Pi OS 11 Bullseye
|
Installing Red on Raspberry Pi OS (Legacy) 11 Bullseye
|
||||||
=============================================
|
======================================================
|
||||||
|
|
||||||
.. include:: _includes/supported-arch-aarch64+armv7l.rst
|
.. include:: _includes/supported-arch-aarch64+armv7l.rst
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
This guide can only be used with Raspberry Pi OS 11 Bullseye,
|
While we do provide support and install instructions for running Red
|
||||||
it will not work with any older (e.g. Raspberry Pi OS 10 Buster)
|
on Raspberry Pi OS (Legacy) 11 Bullseye, we highly recommend installing/upgrading to
|
||||||
or newer (e.g. Raspberry Pi OS 12 Bookworm) releases.
|
the new version - Raspberry Pi OS 12 Bookworm.
|
||||||
You can check your version of Raspberry Pi OS by running:
|
|
||||||
|
If you're not sure what version you are using,
|
||||||
|
you can check your version of Raspberry Pi OS by running:
|
||||||
|
|
||||||
.. prompt:: bash
|
.. prompt:: bash
|
||||||
|
|
||||||
lsb_release -a
|
lsb_release -a
|
||||||
|
|
||||||
If you're not running Bullseye, you should read
|
If you're running Bookworm already, read `install-raspberry-pi-os-12` document instead.
|
||||||
`the post about Bullseye release from Raspberry Pi Foundation <https://www.raspberrypi.com/news/raspberry-pi-os-debian-bullseye/>`__
|
|
||||||
to learn how you can install/upgrade to the new version.
|
If you're using Bullseye, please consider performing a clean install of Bookworm if possible.
|
||||||
|
|
||||||
.. include:: _includes/linux-preamble.rst
|
.. include:: _includes/linux-preamble.rst
|
||||||
|
|
||||||
|
|||||||
38
docs/install_guides/raspberry-pi-os-12.rst
Normal file
38
docs/install_guides/raspberry-pi-os-12.rst
Normal file
@ -0,0 +1,38 @@
|
|||||||
|
.. _install-raspberry-pi-os-12:
|
||||||
|
|
||||||
|
=============================================
|
||||||
|
Installing Red on Raspberry Pi OS 12 Bookworm
|
||||||
|
=============================================
|
||||||
|
|
||||||
|
.. include:: _includes/supported-arch-aarch64+armv7l.rst
|
||||||
|
|
||||||
|
.. note::
|
||||||
|
|
||||||
|
This guide can only be used with Raspberry Pi OS 12 Bookworm,
|
||||||
|
it will not work with any older (e.g. Raspberry Pi OS 11 Bullseye)
|
||||||
|
or newer (e.g. Raspberry Pi OS 13 Trixie) releases.
|
||||||
|
You can check your version of Raspberry Pi OS by running:
|
||||||
|
|
||||||
|
.. prompt:: bash
|
||||||
|
|
||||||
|
lsb_release -a
|
||||||
|
|
||||||
|
.. include:: _includes/linux-preamble.rst
|
||||||
|
|
||||||
|
-------------------------------
|
||||||
|
Installing the pre-requirements
|
||||||
|
-------------------------------
|
||||||
|
|
||||||
|
Raspberry Pi OS "Bookworm" has all required packages available in official repositories. Install them
|
||||||
|
with apt:
|
||||||
|
|
||||||
|
.. prompt:: bash
|
||||||
|
|
||||||
|
sudo apt update
|
||||||
|
sudo apt -y install python3 python3-dev python3-venv git openjdk-17-jre-headless build-essential nano
|
||||||
|
|
||||||
|
.. Include common instructions:
|
||||||
|
|
||||||
|
.. include:: _includes/create-env-with-venv3.11.rst
|
||||||
|
|
||||||
|
.. include:: _includes/install-and-setup-red-unix.rst
|
||||||
@ -52,9 +52,9 @@ Operating system version Supported architectures Ideally supported u
|
|||||||
================================ ======================= ============================================================
|
================================ ======================= ============================================================
|
||||||
Windows 10 x86-64 `End/Retirement Date <https://docs.microsoft.com/en-us/lifecycle/products/windows-10-home-and-pro>`__
|
Windows 10 x86-64 `End/Retirement Date <https://docs.microsoft.com/en-us/lifecycle/products/windows-10-home-and-pro>`__
|
||||||
Windows 11 x86-64 `Retirement Date <https://docs.microsoft.com/en-us/lifecycle/products/windows-11-home-and-pro-version-21h2>`__
|
Windows 11 x86-64 `Retirement Date <https://docs.microsoft.com/en-us/lifecycle/products/windows-11-home-and-pro-version-21h2>`__
|
||||||
macOS 11 (Big Sur) x86-64, aarch64 ~2023-10
|
|
||||||
macOS 12 (Monterey) x86-64, aarch64 ~2024-10
|
macOS 12 (Monterey) x86-64, aarch64 ~2024-10
|
||||||
macOS 13 (Ventura) x86-64, aarch64 ~2025-10
|
macOS 13 (Ventura) x86-64, aarch64 ~2025-10
|
||||||
|
macOS 14 (Sonoma) x86-64, aarch64 ~2026-10
|
||||||
Alma Linux 8 x86-64, aarch64 2029-05-31 (`How long will CloudLinux support AlmaLinux? <https://wiki.almalinux.org/FAQ.html#how-long-will-almalinux-be-supported>`__)
|
Alma Linux 8 x86-64, aarch64 2029-05-31 (`How long will CloudLinux support AlmaLinux? <https://wiki.almalinux.org/FAQ.html#how-long-will-almalinux-be-supported>`__)
|
||||||
Alma Linux 9 x86-64, aarch64 2032-05-31
|
Alma Linux 9 x86-64, aarch64 2032-05-31
|
||||||
Arch Linux x86-64 forever (support is only provided for an up-to-date system)
|
Arch Linux x86-64 forever (support is only provided for an up-to-date system)
|
||||||
@ -63,15 +63,14 @@ CentOS Stream 8 x86-64, aarch64 2024-05-31 (`end of
|
|||||||
CentOS Stream 9 x86-64, aarch64 2027-05-31 (`expected EOL <https://centos.org/stream9/#timeline>`__)
|
CentOS Stream 9 x86-64, aarch64 2027-05-31 (`expected EOL <https://centos.org/stream9/#timeline>`__)
|
||||||
Debian 11 Bullseye x86-64, aarch64, armv7l ~2024-07 (`End of life <https://wiki.debian.org/DebianReleases#Production_Releases>`__)
|
Debian 11 Bullseye x86-64, aarch64, armv7l ~2024-07 (`End of life <https://wiki.debian.org/DebianReleases#Production_Releases>`__)
|
||||||
Debian 12 Bookworm x86-64, aarch64, armv7l ~2026-09 (`End of life <https://wiki.debian.org/DebianReleases#Production_Releases>`__)
|
Debian 12 Bookworm x86-64, aarch64, armv7l ~2026-09 (`End of life <https://wiki.debian.org/DebianReleases#Production_Releases>`__)
|
||||||
Fedora Linux 37 x86-64, aarch64 2023-11-14 (`End of Life <https://docs.fedoraproject.org/en-US/releases/lifecycle/#_maintenance_schedule>`__)
|
|
||||||
Fedora Linux 38 x86-64, aarch64 2024-05-14 (`End of Life <https://docs.fedoraproject.org/en-US/releases/lifecycle/#_maintenance_schedule>`__)
|
Fedora Linux 38 x86-64, aarch64 2024-05-14 (`End of Life <https://docs.fedoraproject.org/en-US/releases/lifecycle/#_maintenance_schedule>`__)
|
||||||
openSUSE Leap 15.4 x86-64, aarch64 2023-11-30 (`end of maintenance life cycle <https://en.opensuse.org/Lifetime#openSUSE_Leap>`__)
|
Fedora Linux 39 x86-64, aarch64 2024-11-12 (`End of Life <https://docs.fedoraproject.org/en-US/releases/lifecycle/#_maintenance_schedule>`__)
|
||||||
openSUSE Leap 15.5 x86-64, aarch64 2024-12-31 (`end of maintenance life cycle <https://en.opensuse.org/Lifetime#openSUSE_Leap>`__)
|
openSUSE Leap 15.5 x86-64, aarch64 2024-12-31 (`end of maintenance life cycle <https://en.opensuse.org/Lifetime#openSUSE_Leap>`__)
|
||||||
openSUSE Tumbleweed x86-64, aarch64 forever (support is only provided for an up-to-date system)
|
openSUSE Tumbleweed x86-64, aarch64 forever (support is only provided for an up-to-date system)
|
||||||
Oracle Linux 8 x86-64, aarch64 2029-07-31 (`End of Premier Support <https://www.oracle.com/us/support/library/elsp-lifetime-069338.pdf>`__)
|
Oracle Linux 8 x86-64, aarch64 2029-07-31 (`End of Premier Support <https://www.oracle.com/us/support/library/elsp-lifetime-069338.pdf>`__)
|
||||||
Oracle Linux 9 x86-64, aarch64 2032-06-31 (`End of Premier Support <https://www.oracle.com/us/support/library/elsp-lifetime-069338.pdf>`__)
|
Oracle Linux 9 x86-64, aarch64 2032-06-31 (`End of Premier Support <https://www.oracle.com/us/support/library/elsp-lifetime-069338.pdf>`__)
|
||||||
Raspberry Pi OS (Legacy) 10 armv7l ~2023-12 (approximate date of release of Raspberry Pi OS 12)
|
Raspberry Pi OS (Legacy) 11 armv7l ~2025-10 (approximate date of release of Raspberry Pi OS 13)
|
||||||
Raspberry Pi OS 11 aarch64, armv7l ~2023-12 (approximate date of release of Raspberry Pi OS 12)
|
Raspberry Pi OS 12 aarch64, armv7l ~2025-10 (approximate date of release of Raspberry Pi OS 13)
|
||||||
RHEL 8 (latest) x86-64, aarch64 2029-05-31 (`End of Maintenance Support <https://access.redhat.com/support/policy/updates/errata#Life_Cycle_Dates>`__)
|
RHEL 8 (latest) x86-64, aarch64 2029-05-31 (`End of Maintenance Support <https://access.redhat.com/support/policy/updates/errata#Life_Cycle_Dates>`__)
|
||||||
RHEL 8.6 x86-64, aarch64 2024-05-31 (`End of Extended Update Support <https://access.redhat.com/support/policy/updates/errata#Extended_Update_Support>`__)
|
RHEL 8.6 x86-64, aarch64 2024-05-31 (`End of Extended Update Support <https://access.redhat.com/support/policy/updates/errata#Extended_Update_Support>`__)
|
||||||
RHEL 8.8 x86-64, aarch64 2025-05-31 (`End of Extended Update Support <https://access.redhat.com/support/policy/updates/errata#Extended_Update_Support>`__)
|
RHEL 8.8 x86-64, aarch64 2025-05-31 (`End of Extended Update Support <https://access.redhat.com/support/policy/updates/errata#Extended_Update_Support>`__)
|
||||||
@ -82,8 +81,7 @@ Rocky Linux 8 x86-64, aarch64 2029-05-31 (`end-of
|
|||||||
Rocky Linux 9 x86-64, aarch64 2032-05-31 (`end-of-life <https://rockylinux.org/download/>`__)
|
Rocky Linux 9 x86-64, aarch64 2032-05-31 (`end-of-life <https://rockylinux.org/download/>`__)
|
||||||
Ubuntu 20.04 LTS x86-64, aarch64 2025-04-30 (`End of Standard Support <https://wiki.ubuntu.com/Releases#Current>`__)
|
Ubuntu 20.04 LTS x86-64, aarch64 2025-04-30 (`End of Standard Support <https://wiki.ubuntu.com/Releases#Current>`__)
|
||||||
Ubuntu 22.04 LTS x86-64, aarch64 2027-04-30 (`End of Standard Support <https://wiki.ubuntu.com/Releases#Current>`__)
|
Ubuntu 22.04 LTS x86-64, aarch64 2027-04-30 (`End of Standard Support <https://wiki.ubuntu.com/Releases#Current>`__)
|
||||||
Ubuntu 22.10 x86-64, aarch64 2023-07-31 (`End of Standard Support <https://wiki.ubuntu.com/Releases#Current>`__)
|
Ubuntu 23.10 x86-64, aarch64 2024-07-31 (`End of Standard Support <https://wiki.ubuntu.com/Releases#Current>`__)
|
||||||
Ubuntu 23.04 x86-64, aarch64 2024-01-31 (`End of Standard Support <https://wiki.ubuntu.com/Releases#Current>`__)
|
|
||||||
================================ ======================= ============================================================
|
================================ ======================= ============================================================
|
||||||
|
|
||||||
.. _developer-guarantees:
|
.. _developer-guarantees:
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user