mirror of
https://github.com/pterodactyl/documentation.git
synced 2025-12-10 10:44:43 -06:00
Added SSL Troubleshooting & Fixed Spelling Errors
This commit is contained in:
parent
8de8536a67
commit
2ff3797893
@ -11,13 +11,13 @@ day-to-day basis.
|
|||||||
## Pick a Codename
|
## Pick a Codename
|
||||||
If this is going to be a major version release `0.X` or `1.X` (not `0.0.X`), you will need to have a codename picked
|
If this is going to be a major version release `0.X` or `1.X` (not `0.0.X`), you will need to have a codename picked
|
||||||
out for the release. This should be some type of rhyme or otherwise creative name, ideally using some type of Pterodactyl
|
out for the release. This should be some type of rhyme or otherwise creative name, ideally using some type of Pterodactyl
|
||||||
releated species name.
|
related species name.
|
||||||
|
|
||||||
## Create the Release Branch
|
## Create the Release Branch
|
||||||
Releases should be created as their own branch on Github, following the GitFlow model. This means you'll need to create
|
Releases should be created as their own branch on Github, following the GitFlow model. This means you'll need to create
|
||||||
a `release/vX.X.X` branch. Once the branch is created you need to update the version number for the software. For the Panel
|
a `release/vX.X.X` branch. Once the branch is created you need to update the version number for the software. For the Panel
|
||||||
this requires editing `config/app.php` and setting the specific `APP_VERSION` _without_ a preceeding `v`. For the Daemon,
|
this requires editing `config/app.php` and setting the specific `APP_VERSION` _without_ a preceding `v`. For the Daemon,
|
||||||
you need to edit `package.json` and set the `version` field, again _without_ a preceeding `v`.
|
you need to edit `package.json` and set the `version` field, again _without_ a preceding `v`.
|
||||||
|
|
||||||
Once you've created the branch and update the relevant file publish the branch to Github to begin the next steps.
|
Once you've created the branch and update the relevant file publish the branch to Github to begin the next steps.
|
||||||
|
|
||||||
|
|||||||
@ -12,12 +12,12 @@ is because the internal logic the Panel is using to determine how links should b
|
|||||||
HTTP, and not over HTTPS.
|
HTTP, and not over HTTPS.
|
||||||
|
|
||||||
You will need to edit the `.env` file in the Panel's root directory to contain `TRUSTED_PROXIES=*` at minimum. We
|
You will need to edit the `.env` file in the Panel's root directory to contain `TRUSTED_PROXIES=*` at minimum. We
|
||||||
highly suggest providing a specific IP address (or comma seperated list of IPs) rather than allowing `*`. For example,
|
highly suggest providing a specific IP address (or comma separated list of IPs) rather than allowing `*`. For example,
|
||||||
if your proxy is running on the same machine as the server, chances are that something like `TRUSTED_PROXIES=127.0.0.1`
|
if your proxy is running on the same machine as the server, chances are that something like `TRUSTED_PROXIES=127.0.0.1`
|
||||||
will work for you.
|
will work for you.
|
||||||
|
|
||||||
### Cloudflare Specific Configuration
|
### Cloudflare Specific Configuration
|
||||||
If you're using Cloudflares Flexible SSL you should set `TRUSTED_PROXIES` to contain [their IP addresses](https://www.cloudflare.com/ips/).
|
If you're using Cloudflare's Flexible SSL you should set `TRUSTED_PROXIES` to contain [their IP addresses](https://www.cloudflare.com/ips/).
|
||||||
Below is an example of how to set this.
|
Below is an example of how to set this.
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|||||||
@ -44,7 +44,7 @@ local.ERROR: ErrorException: file_put_contents(...): failed to open stream: Perm
|
|||||||
From this error we can determine that there was an error performing a [file_put_contents()](http://php.net/manual/en/function.file-put-contents.php) call, and the error was
|
From this error we can determine that there was an error performing a [file_put_contents()](http://php.net/manual/en/function.file-put-contents.php) call, and the error was
|
||||||
that we couldn't open the file because permissions were denied. Its okay if you don't understand the error at all, but
|
that we couldn't open the file because permissions were denied. Its okay if you don't understand the error at all, but
|
||||||
it does help you get faster support if you're able to provide these logs, and at least find the source of the error.
|
it does help you get faster support if you're able to provide these logs, and at least find the source of the error.
|
||||||
Sometimes the errors are pretty strightforward and will tell you exactly what went wrong, such as a `ConnectionException`
|
Sometimes the errors are pretty straightforward and will tell you exactly what went wrong, such as a `ConnectionException`
|
||||||
being thrown when the Panel can't connect to the Daemon.
|
being thrown when the Panel can't connect to the Daemon.
|
||||||
|
|
||||||
### Utilizing GREP
|
### Utilizing GREP
|
||||||
@ -116,7 +116,7 @@ installation of the Panel.
|
|||||||
When restoring backups you should _always_ restore the `.env` file!
|
When restoring backups you should _always_ restore the `.env` file!
|
||||||
:::
|
:::
|
||||||
|
|
||||||
Sometimes when using the Panel you'll unexpectely encounter a broken page, and upon checking the logs you'll see
|
Sometimes when using the Panel you'll unexpectedly encounter a broken page, and upon checking the logs you'll see
|
||||||
an exception mentioning an invalid MAC when decrypting. This error is caused by mismatched `APP_KEY`s in your `.env` file
|
an exception mentioning an invalid MAC when decrypting. This error is caused by mismatched `APP_KEY`s in your `.env` file
|
||||||
when the data was encrypted versus decrypted.
|
when the data was encrypted versus decrypted.
|
||||||
|
|
||||||
|
|||||||
@ -34,3 +34,25 @@ which provides more options, and is much more powerful than certbot.
|
|||||||
``` text
|
``` text
|
||||||
certbot renew
|
certbot renew
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
If you get a `Insecure Connection` or related when trying to access your panel, it is likely that the SSL has expired.
|
||||||
|
This can be easily fixed by renewing the SSL certificate, although using the command
|
||||||
|
``` text
|
||||||
|
certbot renew
|
||||||
|
```
|
||||||
|
Wont do the job. As it'll give a error such as `Error: Attempting to renew cert (domain) from /etc/letsencrypt/renew/domain.conf produced an unexpected error`.
|
||||||
|
This will happen especially if your running NGINX instead of Apache, the solution for this is to stop NGINX, renew the certificate then start NGINX once again.
|
||||||
|
You can do this by running,
|
||||||
|
```bash
|
||||||
|
systemctl stop NGINX
|
||||||
|
```
|
||||||
|
To stop the NGINX service. Now you need to renew the certificate, you can do this by running,
|
||||||
|
```bash
|
||||||
|
certbot renew
|
||||||
|
```
|
||||||
|
Wait for the process to complete.
|
||||||
|
Once it has, you may now re-start the NGINX service using,
|
||||||
|
```bash
|
||||||
|
systemctl start NGINX
|
||||||
|
```
|
||||||
|
|||||||
@ -25,7 +25,7 @@ to `somePassword`.
|
|||||||
``` sql
|
``` sql
|
||||||
USE mysql;
|
USE mysql;
|
||||||
|
|
||||||
# Remeber to change 'somePassword' below to be a unique password specific to this account.
|
# Remember to change 'somePassword' below to be a unique password specific to this account.
|
||||||
CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'somePassword';
|
CREATE USER 'pterodactyl'@'127.0.0.1' IDENTIFIED BY 'somePassword';
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user