diff --git a/.vuepress/config.js b/.vuepress/config.js index f605f5fe..4efd8ac4 100644 --- a/.vuepress/config.js +++ b/.vuepress/config.js @@ -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', ] }, { diff --git a/community/installation-guides/panel/debian11.md b/community/installation-guides/panel/debian11.md new file mode 100644 index 00000000..02f817cb --- /dev/null +++ b/community/installation-guides/panel/debian11.md @@ -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). diff --git a/community/installation-guides/panel/debian9.md b/community/installation-guides/panel/debian9.md deleted file mode 100644 index 580686e7..00000000 --- a/community/installation-guides/panel/debian9.md +++ /dev/null @@ -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). diff --git a/community/installation-guides/wings/debian11.md b/community/installation-guides/wings/debian11.md new file mode 100644 index 00000000..f2371037 --- /dev/null +++ b/community/installation-guides/wings/debian11.md @@ -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. diff --git a/community/installation-guides/wings/debian9.md b/community/installation-guides/wings/debian9.md deleted file mode 100644 index 9e44e6d0..00000000 --- a/community/installation-guides/wings/debian9.md +++ /dev/null @@ -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). diff --git a/panel/1.0/getting_started.md b/panel/1.0/getting_started.md index bf854d88..a18c80ce 100644 --- a/panel/1.0/getting_started.md +++ b/panel/1.0/getting_started.md @@ -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 diff --git a/wings/1.0/installing.md b/wings/1.0/installing.md index 1f3d51e3..096080ca 100644 --- a/wings/1.0/installing.md +++ b/wings/1.0/installing.md @@ -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. |