mirror of
https://github.com/pterodactyl/documentation.git
synced 2025-12-10 00:09:39 -06:00
adding community section
Sorry Dane for the config.js mess but it was necessary for now.
This commit is contained in:
parent
ce9e80ce67
commit
8db2fc12dc
14
.snippets/php-fpm/pterodactyl-centos.conf
Normal file
14
.snippets/php-fpm/pterodactyl-centos.conf
Normal file
@ -0,0 +1,14 @@
|
||||
[pterodactyl]
|
||||
|
||||
user = nginx
|
||||
group = nginx
|
||||
|
||||
listen = /var/run/php-fpm/pterodactyl.sock
|
||||
listen.owner = nginx
|
||||
listen.group = nginx
|
||||
listen.mode = 0750
|
||||
|
||||
pm = ondemand
|
||||
pm.max_children = 9
|
||||
pm.process_idle_timeout = 10s
|
||||
pm.max_requests = 200
|
||||
66
.snippets/webservers/nginx-centos.conf
Normal file
66
.snippets/webservers/nginx-centos.conf
Normal file
@ -0,0 +1,66 @@
|
||||
server_tokens off;
|
||||
|
||||
server {
|
||||
listen 80;
|
||||
server_name <domain>;
|
||||
return 301 https://$server_name$request_uri;
|
||||
}
|
||||
|
||||
server {
|
||||
listen 443 ssl http2;
|
||||
server_name <domain>;
|
||||
|
||||
root /var/www/pterodactyl/public;
|
||||
index index.php;
|
||||
|
||||
access_log /var/log/nginx/pterodactyl.app-access.log;
|
||||
error_log /var/log/nginx/pterodactyl.app-error.log error;
|
||||
|
||||
# allow larger file uploads and longer script runtimes
|
||||
client_max_body_size 100m;
|
||||
client_body_timeout 120s;
|
||||
|
||||
sendfile off;
|
||||
|
||||
# SSL Configuration
|
||||
ssl_certificate /etc/letsencrypt/live/<domain>/fullchain.pem;
|
||||
ssl_certificate_key /etc/letsencrypt/live/<domain>/privkey.pem;
|
||||
ssl_session_cache shared:SSL:10m;
|
||||
ssl_protocols TLSv1.2;
|
||||
ssl_ciphers 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256';
|
||||
ssl_prefer_server_ciphers on;
|
||||
|
||||
# See https://hstspreload.org/ before uncommenting the line below.
|
||||
# add_header Strict-Transport-Security "max-age=15768000; preload;";
|
||||
add_header X-Content-Type-Options nosniff;
|
||||
add_header X-XSS-Protection "1; mode=block";
|
||||
add_header X-Robots-Tag none;
|
||||
add_header Content-Security-Policy "frame-ancestors 'self'";
|
||||
add_header X-Frame-Options DENY;
|
||||
add_header Referrer-Policy same-origin;
|
||||
|
||||
location / {
|
||||
try_files $uri $uri/ /index.php?$query_string;
|
||||
}
|
||||
|
||||
location ~ \.php$ {
|
||||
fastcgi_split_path_info ^(.+\.php)(/.+)$;
|
||||
fastcgi_pass unix:/var/run/php-fpm/pterodactyl.sock;
|
||||
fastcgi_index index.php;
|
||||
include fastcgi_params;
|
||||
fastcgi_param PHP_VALUE "upload_max_filesize = 100M \n post_max_size=100M";
|
||||
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
|
||||
fastcgi_param HTTP_PROXY "";
|
||||
fastcgi_intercept_errors off;
|
||||
fastcgi_buffer_size 16k;
|
||||
fastcgi_buffers 4 16k;
|
||||
fastcgi_connect_timeout 300;
|
||||
fastcgi_send_timeout 300;
|
||||
fastcgi_read_timeout 300;
|
||||
include /etc/nginx/fastcgi_params;
|
||||
}
|
||||
|
||||
location ~ /\.ht {
|
||||
deny all;
|
||||
}
|
||||
}
|
||||
@ -24,7 +24,7 @@ server {
|
||||
|
||||
location ~ \.php$ {
|
||||
fastcgi_split_path_info ^(.+\.php)(/.+)$;
|
||||
fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
|
||||
fastcgi_pass unix:/run/php/php7.2-fpm.sock;
|
||||
fastcgi_index index.php;
|
||||
include fastcgi_params;
|
||||
fastcgi_param PHP_VALUE "upload_max_filesize = 100M \n post_max_size=100M";
|
||||
|
||||
@ -45,7 +45,7 @@ server {
|
||||
|
||||
location ~ \.php$ {
|
||||
fastcgi_split_path_info ^(.+\.php)(/.+)$;
|
||||
fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
|
||||
fastcgi_pass unix:/run/php/php7.2-fpm.sock;
|
||||
fastcgi_index index.php;
|
||||
include fastcgi_params;
|
||||
fastcgi_param PHP_VALUE "upload_max_filesize = 100M \n post_max_size=100M";
|
||||
|
||||
@ -36,12 +36,17 @@ module.exports = {
|
||||
// text: 'API Reference',
|
||||
// link: '/api/'
|
||||
// },
|
||||
{
|
||||
text: 'Community Guides',
|
||||
link: '/community/about.md',
|
||||
},
|
||||
{
|
||||
text: 'Get Help',
|
||||
link: 'https://pterodactyl.io/discord'
|
||||
}
|
||||
],
|
||||
sidebar: [
|
||||
sidebar: {
|
||||
'/project/': [
|
||||
{
|
||||
title: 'Project Information',
|
||||
collapsable: false,
|
||||
@ -96,7 +101,200 @@ module.exports = {
|
||||
// '/',
|
||||
// ]
|
||||
// }
|
||||
],
|
||||
'/panel/': [
|
||||
{
|
||||
title: 'Project Information',
|
||||
collapsable: false,
|
||||
children: [
|
||||
'/project/introduction.md',
|
||||
'/project/about.md',
|
||||
'/project/terms.md',
|
||||
]
|
||||
},
|
||||
{
|
||||
title: 'Panel',
|
||||
collapsable: false,
|
||||
children: [
|
||||
'/panel/getting_started',
|
||||
'/panel/webserver_configuration',
|
||||
'/panel/upgrading',
|
||||
'/panel/configuration',
|
||||
'/panel/troubleshooting',
|
||||
]
|
||||
},
|
||||
{
|
||||
title: 'Daemon',
|
||||
collapsable: false,
|
||||
children: [
|
||||
'/daemon/installing',
|
||||
'/daemon/upgrading',
|
||||
'/daemon/configuration',
|
||||
'/daemon/kernel_modifications',
|
||||
'/daemon/debian_8_docker',
|
||||
]
|
||||
},
|
||||
{
|
||||
title: 'Tutorials',
|
||||
collapsable: false,
|
||||
children: [
|
||||
'/tutorials/mysql_setup.md',
|
||||
'/tutorials/creating_ssl_certificates.md',
|
||||
],
|
||||
},
|
||||
{
|
||||
title: 'Development & Ops',
|
||||
collapsable: true,
|
||||
children: [
|
||||
'/ops/publish_release.md',
|
||||
],
|
||||
},
|
||||
// {
|
||||
// title: 'API Reference',
|
||||
// collapsable: true,
|
||||
// children: [
|
||||
// '/',
|
||||
// ]
|
||||
// }
|
||||
],
|
||||
'/daemon/': [
|
||||
{
|
||||
title: 'Project Information',
|
||||
collapsable: false,
|
||||
children: [
|
||||
'/project/introduction.md',
|
||||
'/project/about.md',
|
||||
'/project/terms.md',
|
||||
]
|
||||
},
|
||||
{
|
||||
title: 'Panel',
|
||||
collapsable: false,
|
||||
children: [
|
||||
'/panel/getting_started',
|
||||
'/panel/webserver_configuration',
|
||||
'/panel/upgrading',
|
||||
'/panel/configuration',
|
||||
'/panel/troubleshooting',
|
||||
]
|
||||
},
|
||||
{
|
||||
title: 'Daemon',
|
||||
collapsable: false,
|
||||
children: [
|
||||
'/daemon/installing',
|
||||
'/daemon/upgrading',
|
||||
'/daemon/configuration',
|
||||
'/daemon/kernel_modifications',
|
||||
'/daemon/debian_8_docker',
|
||||
]
|
||||
},
|
||||
{
|
||||
title: 'Tutorials',
|
||||
collapsable: false,
|
||||
children: [
|
||||
'/tutorials/mysql_setup.md',
|
||||
'/tutorials/creating_ssl_certificates.md',
|
||||
],
|
||||
},
|
||||
{
|
||||
title: 'Development & Ops',
|
||||
collapsable: true,
|
||||
children: [
|
||||
'/ops/publish_release.md',
|
||||
],
|
||||
},
|
||||
// {
|
||||
// title: 'API Reference',
|
||||
// collapsable: true,
|
||||
// children: [
|
||||
// '/',
|
||||
// ]
|
||||
// }
|
||||
],
|
||||
'/tutorials/': [
|
||||
{
|
||||
title: 'Project Information',
|
||||
collapsable: false,
|
||||
children: [
|
||||
'/project/introduction.md',
|
||||
'/project/about.md',
|
||||
'/project/terms.md',
|
||||
]
|
||||
},
|
||||
{
|
||||
title: 'Panel',
|
||||
collapsable: false,
|
||||
children: [
|
||||
'/panel/getting_started',
|
||||
'/panel/webserver_configuration',
|
||||
'/panel/upgrading',
|
||||
'/panel/configuration',
|
||||
'/panel/troubleshooting',
|
||||
]
|
||||
},
|
||||
{
|
||||
title: 'Daemon',
|
||||
collapsable: false,
|
||||
children: [
|
||||
'/daemon/installing',
|
||||
'/daemon/upgrading',
|
||||
'/daemon/configuration',
|
||||
'/daemon/kernel_modifications',
|
||||
'/daemon/debian_8_docker',
|
||||
]
|
||||
},
|
||||
{
|
||||
title: 'Tutorials',
|
||||
collapsable: false,
|
||||
children: [
|
||||
'/tutorials/mysql_setup.md',
|
||||
'/tutorials/creating_ssl_certificates.md',
|
||||
],
|
||||
},
|
||||
{
|
||||
title: 'Development & Ops',
|
||||
collapsable: true,
|
||||
children: [
|
||||
'/ops/publish_release.md',
|
||||
],
|
||||
},
|
||||
// {
|
||||
// title: 'API Reference',
|
||||
// collapsable: true,
|
||||
// children: [
|
||||
// '/',
|
||||
// ]
|
||||
// }
|
||||
],
|
||||
'/community/':[
|
||||
{
|
||||
title: 'Community Guides',
|
||||
collapsable: false,
|
||||
children: [
|
||||
'/community/about.md',
|
||||
]
|
||||
},
|
||||
{
|
||||
title: 'Install Panel',
|
||||
collapsable: false,
|
||||
children: [
|
||||
'/community/install/panel/centos7.md',
|
||||
'/community/install/panel/ubuntu1804.md',
|
||||
'/community/install/panel/debian9.md',
|
||||
]
|
||||
},
|
||||
{
|
||||
title: 'Install Daemon',
|
||||
collapsable: false,
|
||||
children: [
|
||||
'/community/install/daemon/centos7.md',
|
||||
'/community/install/daemon/ubuntu1804.md',
|
||||
'/community/install/daemon/debian9.md',
|
||||
]
|
||||
},
|
||||
]
|
||||
}
|
||||
},
|
||||
postcss: {
|
||||
plugins: [
|
||||
|
||||
5
community/about.md
Normal file
5
community/about.md
Normal file
@ -0,0 +1,5 @@
|
||||
# Introduction
|
||||
This is the community guide section of the site.
|
||||
|
||||
##
|
||||
This is the area for community maintained guides that have been validated before beign added.
|
||||
46
community/install/daemon/centos7.md
Normal file
46
community/install/daemon/centos7.md
Normal file
@ -0,0 +1,46 @@
|
||||
# Install wings on CentOS 7
|
||||
|
||||
This guide covers the installation of the requirements for a daemon with SSL enabled.
|
||||
|
||||
[[toc]]
|
||||
|
||||
## Install Requirements
|
||||
|
||||
The daemon requirements can be found [here](/daemon/installing.md#system-requirements)
|
||||
|
||||
### General Requirements
|
||||
```bash
|
||||
yum install -y tar unzip make gcc gcc-c++ python
|
||||
```
|
||||
|
||||
### Docker
|
||||
|
||||
```bash
|
||||
yum install -y yum-utils device-mapper-persistent-data lvm2
|
||||
|
||||
yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
|
||||
|
||||
yum install -y docker-ce
|
||||
|
||||
systemctl enable docker
|
||||
systemctl start docker
|
||||
```
|
||||
|
||||
### nodejs
|
||||
|
||||
```bash
|
||||
curl --silent --location https://rpm.nodesource.com/setup_8.x | bash -
|
||||
yum install -y nodejs
|
||||
```
|
||||
|
||||
### server ports
|
||||
|
||||
```bash
|
||||
firewall-cmd --add-port 8080/tcp --permanent
|
||||
firewall-cmd --add-port 2022/tcp --permanent
|
||||
firewall-cmd --permanent --zone=trusted --change-interface=docker0
|
||||
firewall-cmd --reload
|
||||
```
|
||||
|
||||
## Installing the daemon
|
||||
Follow the regular guide to install the [daemon](/daemon/installing.md#installing-daemon-software)
|
||||
47
community/install/daemon/debian9.md
Normal file
47
community/install/daemon/debian9.md
Normal file
@ -0,0 +1,47 @@
|
||||
# Install wings on Debian 9
|
||||
|
||||
This guide covers the installation of the requirements for a daemon with SSL enabled.
|
||||
|
||||
[[toc]]
|
||||
|
||||
## Install Requirements
|
||||
|
||||
The daemon requirements can be found [here](/daemon/installing.md#system-requirements)
|
||||
|
||||
### General Requirements
|
||||
```bash
|
||||
apt install -y zip unzip tar make gcc g++ python curl gnupg
|
||||
```
|
||||
|
||||
### Docker
|
||||
|
||||
```bash
|
||||
## install apt tools
|
||||
apt install 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
|
||||
apt install docker-ce
|
||||
|
||||
systemctl enable docker
|
||||
systemctl start docker
|
||||
```
|
||||
|
||||
### nodejs
|
||||
|
||||
```bash
|
||||
## Install nodejs repo
|
||||
curl -sL https://deb.nodesource.com/setup_8.x | bash -
|
||||
|
||||
## Install nodejs
|
||||
apt install -y nodejs
|
||||
```
|
||||
|
||||
## Installing the daemon
|
||||
Follow the regular guide to install the [daemon](/daemon/installing.md#installing-daemon-software)
|
||||
32
community/install/daemon/ubuntu1804.md
Normal file
32
community/install/daemon/ubuntu1804.md
Normal file
@ -0,0 +1,32 @@
|
||||
# Install wings on Ubuntu 18.04
|
||||
|
||||
This guide covers the installation of the requirements for a daemon with SSL enabled.
|
||||
|
||||
[[toc]]
|
||||
|
||||
## Install Requirements
|
||||
|
||||
The daemon requirements can be found [here](/daemon/installing.md#system-requirements)
|
||||
|
||||
### General Requirements
|
||||
```bash
|
||||
apt install -y zip unzip tar make gcc g++ python
|
||||
```
|
||||
|
||||
### Docker
|
||||
|
||||
```bash
|
||||
apt install -y docker.io
|
||||
|
||||
systemctl enable docker
|
||||
systemctl start docker
|
||||
```
|
||||
|
||||
### nodejs
|
||||
|
||||
```bash
|
||||
apt install -y nodejs npm
|
||||
```
|
||||
|
||||
## Installing the daemon
|
||||
Follow the regular guide to install the [daemon](/daemon/installing.md#installing-daemon-software)
|
||||
143
community/install/panel/centos7.md
Normal file
143
community/install/panel/centos7.md
Normal file
@ -0,0 +1,143 @@
|
||||
# Install pterodactyl on CentOS 7
|
||||
|
||||
This guide covers the installation of the requirements for a panel with SSL enabled.
|
||||
|
||||
[[toc]]
|
||||
|
||||
## Install Requirements
|
||||
|
||||
The panel requirements can be found [here](/panel/getting_started.md#dependencies)
|
||||
|
||||
### MariaDB
|
||||
|
||||
```bash
|
||||
## Install Repos
|
||||
cat <<EOF > /etc/yum.repos.d/mariadb.repo
|
||||
# MariaDB 10.2 CentOS repository list - created 2017-07-14 12:40 UTC
|
||||
# http://downloads.mariadb.org/mariadb/repositories/
|
||||
[mariadb]
|
||||
name = MariaDB
|
||||
baseurl = http://yum.mariadb.org/10.2/centos7-amd64
|
||||
gpgkey=https://yum.mariadb.org/RPM-GPG-KEY-MariaDB
|
||||
gpgcheck=1
|
||||
EOF
|
||||
|
||||
## Get yum updates
|
||||
yum update -y
|
||||
|
||||
## Install MariaDB 10.2
|
||||
yum install -y MariaDB-common MariaDB-server
|
||||
|
||||
## Start maraidb
|
||||
systemctl start mariadb
|
||||
systemctl enable mariadb
|
||||
```
|
||||
|
||||
### PHP 7.2
|
||||
We recommend the ius repo to get the latest php packages.
|
||||
|
||||
```bash
|
||||
## Install Repos
|
||||
yum install -y epel-release https://centos7.iuscommunity.org/ius-release.rpm
|
||||
|
||||
## Get yum updates
|
||||
yum update -y
|
||||
|
||||
## Install PHP 7.2
|
||||
yum install -y php72u-php php72u-common php72u-fpm php72u-cli php72u-json php72u-mysqlnd php72u-mcrypt php72u-gd php72u-mbstring php72u-pdo php72u-zip php72u-bcmath php72u-dom php72u-opcache
|
||||
```
|
||||
|
||||
### nginx
|
||||
|
||||
```bash
|
||||
yum install -y nginx
|
||||
|
||||
firewall-cmd --add-service=http --permanent
|
||||
firewall-cmd --add-service=https --permanent
|
||||
firewall-cmd --reload
|
||||
```
|
||||
|
||||
### Redis
|
||||
|
||||
```bash
|
||||
yum install -y redis40u
|
||||
|
||||
systemctl start redis
|
||||
systemctl enable redis
|
||||
```
|
||||
|
||||
### utilities
|
||||
|
||||
#### certbot
|
||||
```bash
|
||||
yum install -y certbot
|
||||
```
|
||||
|
||||
#### composer
|
||||
```bash
|
||||
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
|
||||
```
|
||||
|
||||
## Server Configuriation
|
||||
|
||||
This following section covers the configuration of parts of the server to run the panel.
|
||||
|
||||
### 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
|
||||
We have a tutorial in the tutorial section
|
||||
[Setting up MySQL](/tutorials/mysql_setup.md)
|
||||
|
||||
### PHP
|
||||
|
||||
The default php-fpm configuration is good to use but you need to edit the nginx config to use the ip address.
|
||||
|
||||
The following config is the one that will match the nginx config later in the guide.
|
||||
|
||||
<<< @/.snippets/php-fpm/pterodactyl-centos.conf
|
||||
|
||||
Start and enable php-fpm on the system.
|
||||
```bash
|
||||
systemctl enable php-fpm
|
||||
systemctl start php-fpm
|
||||
```
|
||||
|
||||
### nginx
|
||||
|
||||
follow the [tutorial](/tutorials/creating_ssl_certificates.md) on generating an SSL cert to use.
|
||||
|
||||
#### ssl config
|
||||
<<< @/.snippets/webservers/nginx-centos.conf{5,11,26-27}
|
||||
|
||||
### Redis
|
||||
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 similar to [this guide](https://community.pivotal.io/s/article/How-to-setup-and-run-multiple-Redis-server-instances-on-a-Linux-host)
|
||||
|
||||
## Installing the panel
|
||||
Follow the regular guide to install the [panel](/panel/getting_started.md#installation)
|
||||
134
community/install/panel/debian9.md
Normal file
134
community/install/panel/debian9.md
Normal file
@ -0,0 +1,134 @@
|
||||
# Install pterodactyl on Debian 9
|
||||
|
||||
This guide covers the installation of the requirements for a panel with SSL enabled.
|
||||
|
||||
[[toc]]
|
||||
|
||||
## Install Requirements
|
||||
|
||||
The panel requirements can be found [here](/panel/getting_started.md#dependencies)
|
||||
|
||||
### MariaDB
|
||||
|
||||
```bash
|
||||
apt install -y software-properties-common dirmngr
|
||||
|
||||
## get MariaDB gpg keys
|
||||
apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8
|
||||
|
||||
## install the MariaDB repo
|
||||
add-apt-repository 'deb [arch=amd64,i386,ppc64el] http://mirror.jaleco.com/mariadb/repo/10.1/debian stretch main'
|
||||
|
||||
## Get apt updates
|
||||
apt update
|
||||
|
||||
## Install MariaDB 10.1
|
||||
apt install -y mariadb-common mariadb-server mariadb-client
|
||||
|
||||
## Start maraidb
|
||||
systemctl start mariadb
|
||||
systemctl enable mariadb
|
||||
```
|
||||
|
||||
### PHP 7.2
|
||||
|
||||
```bash
|
||||
## Install the PHP 7.2 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.2
|
||||
apt install -y php7.2 php7.2-cli php7.2-gd php7.2-mysql php7.2-pdo php7.2-mbstring php7.2-tokenizer php7.2-bcmath php7.2-xml php7.2-fpm php7.2-curl php7.2-zip
|
||||
```
|
||||
|
||||
### nginx
|
||||
|
||||
```bash
|
||||
apt install -y nginx
|
||||
```
|
||||
|
||||
### Redis
|
||||
|
||||
```bash
|
||||
apt install -y redis-server
|
||||
|
||||
systemctl start redis-server
|
||||
systemctl enable redis-server
|
||||
```
|
||||
|
||||
### 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 Configuriation
|
||||
|
||||
This following section covers the configuration of parts of the server to run the panel.
|
||||
|
||||
### 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
|
||||
We have a tutorial in the tutorial section
|
||||
[Setting up MySQL](/tutorials/mysql_setup.md)
|
||||
|
||||
### PHP
|
||||
|
||||
The default php-fpm configuration is good to use.
|
||||
|
||||
Start and enable php-fpm on the system.
|
||||
```bash
|
||||
systemctl enable php-fpm
|
||||
systemctl start php-fpm
|
||||
```
|
||||
|
||||
### nginx
|
||||
|
||||
follow the [tutorial](/tutorials/creating_ssl_certificates.md) on generating an SSL cert to use.
|
||||
|
||||
#### ssl config
|
||||
<<< @/.snippets/webservers/nginx.conf{5,11,26-27}
|
||||
|
||||
|
||||
### Redis
|
||||
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 similar to [this guide](https://community.pivotal.io/s/article/How-to-setup-and-run-multiple-Redis-server-instances-on-a-Linux-host)
|
||||
|
||||
## Installing the panel
|
||||
Follow the regular guide to install the [panel](/panel/getting_started.md#installation)
|
||||
121
community/install/panel/ubuntu1804.md
Normal file
121
community/install/panel/ubuntu1804.md
Normal file
@ -0,0 +1,121 @@
|
||||
# Install pterodactyl on Ubuntu 18.04
|
||||
|
||||
This guide covers the installation of the requirements for a panel with SSL enabled.
|
||||
|
||||
[[toc]]
|
||||
|
||||
## Install Requirements
|
||||
|
||||
The panel requirements can be found [here](/panel/getting_started.md#dependencies)
|
||||
|
||||
### MariaDB
|
||||
|
||||
```bash
|
||||
## Get apt updates
|
||||
apt update -y
|
||||
|
||||
## Install MariaDB 10.1
|
||||
apt install -y mariadb-common mariadb-server mariadb-client
|
||||
|
||||
## Start MariaDB
|
||||
systemctl start mariadb
|
||||
systemctl enable mariadb
|
||||
```
|
||||
|
||||
### PHP 7.2
|
||||
|
||||
```bash
|
||||
## Get apt updates
|
||||
apt update -y
|
||||
|
||||
## Install PHP 7.2
|
||||
apt install -y php7.2 php7.2-cli php7.2-gd php7.2-mysql php7.2-pdo php7.2-mbstring php7.2-tokenizer php7.2-bcmath php7.2-xml php7.2-fpm php7.2-curl php7.2-zip
|
||||
```
|
||||
|
||||
### nginx
|
||||
|
||||
```bash
|
||||
apt install -y nginx
|
||||
```
|
||||
|
||||
### Redis
|
||||
|
||||
```bash
|
||||
apt install -y redis-server
|
||||
|
||||
systemctl start redis-server
|
||||
systemctl enable redis-server
|
||||
```
|
||||
|
||||
### utilities
|
||||
|
||||
#### certbot
|
||||
```bash
|
||||
yuaptm install -y certbot
|
||||
```
|
||||
|
||||
#### composer
|
||||
```bash
|
||||
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
|
||||
```
|
||||
|
||||
## Server Configuriation
|
||||
|
||||
This following section covers the configuration of parts of the server to run the panel.
|
||||
|
||||
### 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
|
||||
We have a tutorial in the tutorial section
|
||||
[Setting up MySQL](/tutorials/mysql_setup.md)
|
||||
|
||||
### PHP
|
||||
|
||||
The default php-fpm configuration is good to use.
|
||||
|
||||
Start and enable php-fpm on the system.
|
||||
```bash
|
||||
systemctl enable php-fpm
|
||||
systemctl start php-fpm
|
||||
```
|
||||
|
||||
### nginx
|
||||
|
||||
follow the [tutorial](/tutorials/creating_ssl_certificates.md) on generating an SSL cert to use.
|
||||
|
||||
#### ssl config
|
||||
<<< @/.snippets/webservers/nginx.conf{5,11,26-27}
|
||||
|
||||
|
||||
### Redis
|
||||
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 similar to [this guide](https://community.pivotal.io/s/article/How-to-setup-and-run-multiple-Redis-server-instances-on-a-Linux-host)
|
||||
|
||||
## Installing the panel
|
||||
Follow the regular guide to install the [panel](/panel/getting_started.md#installation)
|
||||
Loading…
x
Reference in New Issue
Block a user