mirror of
https://github.com/pterodactyl/documentation.git
synced 2025-12-12 00:34:12 -06:00
docs: add debian 11 guide and remove Debian 9 (#481)
Co-authored-by: softwarenoob <admin@softwarenoob.com> * Add Debian 11 community guides * Add Ubuntu 22.04 to the supported distro table * Remove Debian 9 due to being EOL
This commit is contained in:
Quinten
GitHub
parent
fdf2d4819c
commit
34d68028a4
@ -77,8 +77,8 @@ module.exports = {
|
|||||||
children: [
|
children: [
|
||||||
'/community/installation-guides/panel/centos7.md',
|
'/community/installation-guides/panel/centos7.md',
|
||||||
'/community/installation-guides/panel/centos8.md',
|
'/community/installation-guides/panel/centos8.md',
|
||||||
'/community/installation-guides/panel/debian9.md',
|
|
||||||
'/community/installation-guides/panel/debian10.md',
|
'/community/installation-guides/panel/debian10.md',
|
||||||
|
'/community/installation-guides/panel/debian11.md',
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
@ -87,8 +87,8 @@ module.exports = {
|
|||||||
children: [
|
children: [
|
||||||
'/community/installation-guides/wings/centos7.md',
|
'/community/installation-guides/wings/centos7.md',
|
||||||
'/community/installation-guides/wings/centos8.md',
|
'/community/installation-guides/wings/centos8.md',
|
||||||
'/community/installation-guides/wings/debian9.md',
|
|
||||||
'/community/installation-guides/wings/debian10.md',
|
'/community/installation-guides/wings/debian10.md',
|
||||||
|
'/community/installation-guides/wings/debian11.md',
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
|
|||||||
55
community/installation-guides/panel/debian11.md
Normal file
55
community/installation-guides/panel/debian11.md
Normal file
@ -0,0 +1,55 @@
|
|||||||
|
# Debian 11
|
||||||
|
|
||||||
|
[[toc]]
|
||||||
|
|
||||||
|
::: tip
|
||||||
|
This guide is based off the [official installation documentation](/panel/1.0/getting_started.md) but is tailored specifically for Debian 11.
|
||||||
|
:::
|
||||||
|
|
||||||
|
## Dependency Installation
|
||||||
|
|
||||||
|
In this guide, we will install the required dependencies for the Pterodactyl panel. After that, you can follow the official installation documentation.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Update package lists
|
||||||
|
apt update -y
|
||||||
|
|
||||||
|
# Install necessary packages
|
||||||
|
apt -y install software-properties-common curl ca-certificates gnupg2 sudo lsb-release
|
||||||
|
|
||||||
|
# Add repository for PHP
|
||||||
|
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/sury-php.list
|
||||||
|
|
||||||
|
curl -fsSL https://packages.sury.org/php/apt.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/sury-keyring.gpg
|
||||||
|
|
||||||
|
# Add repository for Redis
|
||||||
|
curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
|
||||||
|
|
||||||
|
echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list
|
||||||
|
|
||||||
|
# Update package lists
|
||||||
|
apt update -y
|
||||||
|
|
||||||
|
# Install PHP and required extensions
|
||||||
|
apt install -y php8.1 php8.1-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip}
|
||||||
|
|
||||||
|
# MariaDB repo setup script
|
||||||
|
curl -sS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash
|
||||||
|
|
||||||
|
# Install the rest of dependencies
|
||||||
|
apt install -y mariadb-server nginx tar unzip git redis-server
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
### Installing Composer
|
||||||
|
|
||||||
|
Composer is a dependency manager for PHP that allows us to ship everything you'll need code wise to operate the Panel. You'll
|
||||||
|
need composer installed before continuing in this process.
|
||||||
|
|
||||||
|
``` bash
|
||||||
|
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer
|
||||||
|
```
|
||||||
|
|
||||||
|
### Download Files
|
||||||
|
|
||||||
|
Great, now all of the dependencies have been dealt with. Continue the installation by following the [official documentation Download Files section](/panel/1.0/getting_started.md#download-files).
|
||||||
@ -1,122 +0,0 @@
|
|||||||
# Debian 9
|
|
||||||
In this guide we will install Pterodactyl v1.x — including all of it's dependencies — and configure our webserver to serve it using SSL.
|
|
||||||
|
|
||||||
[[toc]]
|
|
||||||
|
|
||||||
::: tip
|
|
||||||
This guide is based off the [official installation documentation](/panel/1.0/getting_started.md) but is tailored specifically for Debian 9.
|
|
||||||
:::
|
|
||||||
|
|
||||||
## Install Requirements
|
|
||||||
We will first begin by installing all of Pterodactyl's [required](/panel/1.0/getting_started.md#dependencies) dependencies.
|
|
||||||
|
|
||||||
### MariaDB
|
|
||||||
```bash
|
|
||||||
## Install the MariaDB repo for debian
|
|
||||||
apt install -y software-properties-common dirmngr
|
|
||||||
curl -sS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | sudo bash
|
|
||||||
|
|
||||||
## Get apt updates
|
|
||||||
apt update
|
|
||||||
|
|
||||||
## Install MariaDB
|
|
||||||
apt install -y mariadb-common mariadb-server mariadb-client
|
|
||||||
|
|
||||||
## Start maraidb
|
|
||||||
systemctl start mariadb
|
|
||||||
systemctl enable mariadb
|
|
||||||
```
|
|
||||||
|
|
||||||
### PHP 7.4
|
|
||||||
```bash
|
|
||||||
## Install the PHP 7.4 repo for debian
|
|
||||||
apt install -y ca-certificates apt-transport-https
|
|
||||||
wget -q https://packages.sury.org/php/apt.gpg -O- | apt-key add -
|
|
||||||
echo "deb https://packages.sury.org/php/ stretch main" | tee /etc/apt/sources.list.d/php.list
|
|
||||||
|
|
||||||
## Get apt updates
|
|
||||||
apt update
|
|
||||||
|
|
||||||
## Install PHP 7.4
|
|
||||||
apt install -y php7.4 php7.4-{cli,gd,mysql,pdo,mbstring,tokenizer,bcmath,xml,fpm,curl,zip}
|
|
||||||
```
|
|
||||||
|
|
||||||
### Nginx
|
|
||||||
```bash
|
|
||||||
apt install -y nginx
|
|
||||||
```
|
|
||||||
|
|
||||||
### Redis
|
|
||||||
```bash
|
|
||||||
apt install -y redis-server
|
|
||||||
|
|
||||||
systemctl start redis-server
|
|
||||||
systemctl enable redis-server
|
|
||||||
```
|
|
||||||
|
|
||||||
### Additional Utilities
|
|
||||||
|
|
||||||
#### Certbot
|
|
||||||
```bash
|
|
||||||
apt install -y certbot curl
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Composer
|
|
||||||
```bash
|
|
||||||
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
|
|
||||||
```
|
|
||||||
|
|
||||||
## Server Configuration
|
|
||||||
This following section covers the configuration of parts of the server to run the panel.
|
|
||||||
|
|
||||||
### Configuring MariaDB
|
|
||||||
The fastest way to set up mariadb is to use the `mysql_secure_installation` command and follow prompts
|
|
||||||
|
|
||||||
```bash
|
|
||||||
mysql_secure_installation
|
|
||||||
```
|
|
||||||
|
|
||||||
The following are safe defaults.
|
|
||||||
|
|
||||||
Change to your own secure password
|
|
||||||
`Set root password? [Y/n] Y`
|
|
||||||
|
|
||||||
Get rid of users that could access the db by default
|
|
||||||
`Remove anonymous users? [Y/n] Y`
|
|
||||||
|
|
||||||
Keep root off the external interfaces
|
|
||||||
`Disallow root login remotely? [Y/n] Y`
|
|
||||||
|
|
||||||
Extra databases that aren't needed
|
|
||||||
`Remove test database and access to it? [Y/n] Y`
|
|
||||||
|
|
||||||
Clears and sets all the changes made
|
|
||||||
`Reload privilege tables now? [Y/n] Y`
|
|
||||||
|
|
||||||
All done! If you've completed all of the above steps, your MariaDB installation should now be secure.
|
|
||||||
|
|
||||||
#### Adding MariaDB user
|
|
||||||
To add your first user to the database, see our tutorial on [setting up MySQL](/tutorials/mysql_setup.md).
|
|
||||||
|
|
||||||
### Setup PHP
|
|
||||||
The default php-fpm configuration is fine to use and can be started and then enabled on the system using the
|
|
||||||
commands below.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
systemctl enable php7.4-fpm
|
|
||||||
systemctl start php7.4-fpm
|
|
||||||
```
|
|
||||||
|
|
||||||
### Nginx
|
|
||||||
Please check our [tutorial](/tutorials/creating_ssl_certificates.md) on generating SSL certificates for more information.
|
|
||||||
|
|
||||||
#### SSL Configuration
|
|
||||||
<<< @/.snippets/webservers/nginx-php7.4.conf{5,11,26-27}
|
|
||||||
|
|
||||||
|
|
||||||
### Redis Setup
|
|
||||||
The default Redis install is perfectly fine for the panel. If you have Redis already in use you may want to look into
|
|
||||||
[running another Redis instance](https://community.pivotal.io/s/article/How-to-setup-and-run-multiple-Redis-server-instances-on-a-Linux-host).
|
|
||||||
|
|
||||||
## Installing the Panel
|
|
||||||
Excellent, we now have all of the required dependencies installed and configured. From here, follow the [official Panel installation documentation](/panel/1.0/getting_started.md#download-files).
|
|
||||||
5
community/installation-guides/wings/debian11.md
Normal file
5
community/installation-guides/wings/debian11.md
Normal file
@ -0,0 +1,5 @@
|
|||||||
|
# Debian 11
|
||||||
|
|
||||||
|
## Install
|
||||||
|
|
||||||
|
There is no additional configuration required for Wings on Debian 11. You can follow the [official Wings install documentation](/wings/1.0/installing.md), which covers Docker installation for Debian.
|
||||||
@ -1,35 +0,0 @@
|
|||||||
# Debian 9
|
|
||||||
In this guide we will install Pterodactyl's Wings v1.X — including all of it's dependencies — and configure it to use a SSL connection.
|
|
||||||
|
|
||||||
[[toc]]
|
|
||||||
|
|
||||||
::: tip
|
|
||||||
This guide is based off the [official installation documentation](/wings/1.0/installing.md) but is tailored specifically for Debian 9.
|
|
||||||
:::
|
|
||||||
|
|
||||||
## Install Requirements
|
|
||||||
We will first begin by installing all of Wings' [required](/wings/1.0/installing.md#dependencies) dependencies.
|
|
||||||
|
|
||||||
### Docker
|
|
||||||
|
|
||||||
```bash
|
|
||||||
## install apt tools
|
|
||||||
apt install -y apt-transport-https ca-certificates curl gnupg2 software-properties-common
|
|
||||||
|
|
||||||
## Import the docker gpg key
|
|
||||||
curl -fsSL https://download.docker.com/linux/debian/gpg | apt-key add -
|
|
||||||
|
|
||||||
## Add the docker stable repo
|
|
||||||
add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable"
|
|
||||||
|
|
||||||
## Install docker
|
|
||||||
apt update -y
|
|
||||||
apt install -y docker-ce
|
|
||||||
|
|
||||||
## Enable docker service
|
|
||||||
systemctl enable docker
|
|
||||||
systemctl start docker
|
|
||||||
```
|
|
||||||
|
|
||||||
## Installing Wings
|
|
||||||
Great, now all of the dependencies have been dealt with. From here follow the [official Wings installation documentation](/wings/1.0/installing.html#enabling-swap).
|
|
||||||
@ -27,11 +27,11 @@ this software on an OpenVZ based system you will — most likely — not
|
|||||||
|------------------|---------|:------------------:|-------------------------------------------------------------|
|
|------------------|---------|:------------------:|-------------------------------------------------------------|
|
||||||
| **Ubuntu** | 18.04 | :white_check_mark: | Documentation written assuming Ubuntu 18.04 as the base OS. |
|
| **Ubuntu** | 18.04 | :white_check_mark: | Documentation written assuming Ubuntu 18.04 as the base OS. |
|
||||||
| | 20.04 | :white_check_mark: | |
|
| | 20.04 | :white_check_mark: | |
|
||||||
|
| | 22.04 | :white_check_mark: | |
|
||||||
| | 22.04 | :white_check_mark: | MariaDB can be installed without the repo setup script. |
|
| | 22.04 | :white_check_mark: | MariaDB can be installed without the repo setup script. |
|
||||||
| **CentOS** | 7 | :white_check_mark: | Extra repos are required. |
|
| **CentOS** | 7 | :white_check_mark: | Extra repos are required. |
|
||||||
| | 8 | :white_check_mark: | Note that CentOS 8 is EOL. Use Rocky or Alma Linux. |
|
| | 8 | :white_check_mark: | Note that CentOS 8 is EOL. Use Rocky or Alma Linux. |
|
||||||
| **Debian** | 9 | :white_check_mark: | Extra repos are required. |
|
| **Debian** | 10 | :white_check_mark: | |
|
||||||
| | 10 | :white_check_mark: | |
|
|
||||||
| | 11 | :white_check_mark: | |
|
| | 11 | :white_check_mark: | |
|
||||||
|
|
||||||
## Dependencies
|
## Dependencies
|
||||||
|
|||||||
@ -20,10 +20,10 @@ only the versions listed below.
|
|||||||
|------------------|---------|:------------------:|-------------------------------------------------------------|
|
|------------------|---------|:------------------:|-------------------------------------------------------------|
|
||||||
| **Ubuntu** | 18.04 | :white_check_mark: | Documentation written assuming Ubuntu 18.04 as the base OS. |
|
| **Ubuntu** | 18.04 | :white_check_mark: | Documentation written assuming Ubuntu 18.04 as the base OS. |
|
||||||
| | 20.04 | :white_check_mark: | |
|
| | 20.04 | :white_check_mark: | |
|
||||||
|
| | 22.04 | :white_check_mark: | |
|
||||||
| **CentOS** | 7 | :white_check_mark: | |
|
| **CentOS** | 7 | :white_check_mark: | |
|
||||||
| | 8 | :white_check_mark: | Note that CentOS 8 is EOL. Use Rocky or Alma Linux. |
|
| | 8 | :white_check_mark: | Note that CentOS 8 is EOL. Use Rocky or Alma Linux. |
|
||||||
| **Debian** | 9 | :white_check_mark: | |
|
| **Debian** | 10 | :white_check_mark: | |
|
||||||
| | 10 | :white_check_mark: | |
|
|
||||||
| | 11 | :white_check_mark: | |
|
| | 11 | :white_check_mark: | |
|
||||||
| **Windows** | All | :x: | This software will not run in Windows environments. |
|
| **Windows** | All | :x: | This software will not run in Windows environments. |
|
||||||
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user