mirror of
https://github.com/pterodactyl/documentation.git
synced 2025-12-10 10:44:43 -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: [
|
||||
'/community/installation-guides/panel/centos7.md',
|
||||
'/community/installation-guides/panel/centos8.md',
|
||||
'/community/installation-guides/panel/debian9.md',
|
||||
'/community/installation-guides/panel/debian10.md',
|
||||
'/community/installation-guides/panel/debian11.md',
|
||||
]
|
||||
},
|
||||
{
|
||||
@ -87,8 +87,8 @@ module.exports = {
|
||||
children: [
|
||||
'/community/installation-guides/wings/centos7.md',
|
||||
'/community/installation-guides/wings/centos8.md',
|
||||
'/community/installation-guides/wings/debian9.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. |
|
||||
| | 20.04 | :white_check_mark: | |
|
||||
| | 22.04 | :white_check_mark: | |
|
||||
| | 22.04 | :white_check_mark: | MariaDB can be installed without the repo setup script. |
|
||||
| **CentOS** | 7 | :white_check_mark: | Extra repos are required. |
|
||||
| | 8 | :white_check_mark: | Note that CentOS 8 is EOL. Use Rocky or Alma Linux. |
|
||||
| **Debian** | 9 | :white_check_mark: | Extra repos are required. |
|
||||
| | 10 | :white_check_mark: | |
|
||||
| **Debian** | 10 | :white_check_mark: | |
|
||||
| | 11 | :white_check_mark: | |
|
||||
|
||||
## 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. |
|
||||
| | 20.04 | :white_check_mark: | |
|
||||
| | 22.04 | :white_check_mark: | |
|
||||
| **CentOS** | 7 | :white_check_mark: | |
|
||||
| | 8 | :white_check_mark: | Note that CentOS 8 is EOL. Use Rocky or Alma Linux. |
|
||||
| **Debian** | 9 | :white_check_mark: | |
|
||||
| | 10 | :white_check_mark: | |
|
||||
| **Debian** | 10 | :white_check_mark: | |
|
||||
| | 11 | :white_check_mark: | |
|
||||
| **Windows** | All | :x: | This software will not run in Windows environments. |
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user