PteroTheme/README.md

136 lines
4.3 KiB
Markdown
Raw Normal View History

2023-08-06 17:34:25 +01:00
# Nook Theme
NookTheme is a free and open source [Pterodactyl theme](https://pterodactyl.io) designed to be simple, clean, and modern.
2017-02-15 23:03:30 +00:00
2023-08-07 15:08:00 +01:00
![Image](https://i.imgur.com/AFjHGBr.png)
2017-09-10 02:54:57 +01:00
2023-08-06 17:34:25 +01:00
<details>
<summary>View Screnshots</summary>
2022-10-30 19:58:29 +00:00
2023-08-06 17:34:25 +01:00
![Image](https://i.imgur.com/CNxF3iT.png)
![Image](https://i.imgur.com/IflRtEX.png)
![Image](https://i.imgur.com/vNLK5jP.png)
![Image](https://i.imgur.com/dnxV2CS.png)
</details>
2018-08-03 17:05:52 +01:00
2023-08-06 17:34:25 +01:00
## Installation
2018-02-25 17:38:38 +00:00
2023-08-07 15:08:00 +01:00
This will update your panel to the latest version of NookTheme panel is based. <br>
You can see the version in the current branch name.
### Enter Maintenance Mode
Whenever you are performing an update you should be sure to place your Panel into maintenance mode. This will prevent
users from encountering unexpected errors and ensure everything can be updated before users encounter
potentially new features.
```bash
2023-08-06 17:34:25 +01:00
cd /var/www/pterodactyl
2023-08-06 17:34:25 +01:00
php artisan down
```
2023-08-07 15:08:00 +01:00
### Download the theme
The first step in the update process is to download the new panel files from GitHub. The command below will download
the release archive for the most recent version of Pterodactyl, save it in the current directory and will automatically
unpack the archive into your current folder.
2023-08-06 17:34:25 +01:00
2023-08-07 15:08:00 +01:00
```bash
2023-08-06 17:34:25 +01:00
curl -L https://github.com/Nookure/NookTheme/releases/latest/download/panel.tar.gz | tar -xzv
```
2023-08-07 15:08:00 +01:00
Once all of the files are downloaded we need to set the correct permissions on the cache and storage directories to avoid
any webserver related errors.
```bash
2023-08-06 17:34:25 +01:00
chmod -R 755 storage/* bootstrap/cache
```
2023-08-07 15:08:00 +01:00
### Update Dependencies
After you've downloaded all of the new files you will need to upgrade the core components of the panel. To do this,
simply run the commands below and follow any prompts.
```bash
2023-08-06 17:34:25 +01:00
composer install --no-dev --optimize-autoloader
```
2023-08-07 15:08:00 +01:00
### Clear Compiled Template Cache
You'll also want to clear the compiled template cache to ensure that new and modified templates show up correctly for
users.
```bash
2023-08-06 17:34:25 +01:00
php artisan view:clear
php artisan config:clear
```
2023-08-07 15:08:00 +01:00
### Database Updates
You'll also need to update your database schema for the newest version of Pterodactyl. Running the command below
will update the schema and ensure the default eggs we ship are up to date (and add any new ones we might have). Just
remember, _never edit core eggs we ship_! They will be overwritten by this update process.
```bash
php artisan migrate --seed --force
```
### Set Permissions
The last step is to set the proper owner of the files to be the user that runs your webserver. In most cases this
is `www-data` but can vary from system to system &mdash; sometimes being `nginx`, `caddy`, `apache`, or even `nobody`.
```bash
# If using NGINX or Apache (not on CentOS):
chown -R www-data:www-data /var/www/pterodactyl/*
# If using NGINX on CentOS:
chown -R nginx:nginx /var/www/pterodactyl/*
# If using Apache on CentOS
chown -R apache:apache /var/www/pterodactyl/*
```
### Restarting Queue Workers
After _every_ update you should restart the queue worker to ensure that the new code is loaded in and used.
```bash
php artisan queue:restart
```
### Exit Maintenance Mode
Now that everything has been updated you need to exit maintenance mode so that the Panel can resume accepting
connections.
```bash
php artisan up
```
2022-01-02 15:19:16 +00:00
## Documentation
2022-10-30 19:58:29 +00:00
2022-01-02 15:19:16 +00:00
* [Panel Documentation](https://pterodactyl.io/panel/1.0/getting_started.html)
* [Wings Documentation](https://pterodactyl.io/wings/1.0/installing.html)
* [Community Guides](https://pterodactyl.io/community/about.html)
2023-08-06 17:34:25 +01:00
* Or, get additional help [via Discord](https://discord.nookure.com/)
2024-05-08 15:18:24 +01:00
## Star History
<a href="https://star-history.com/#Nookure/NookTheme&Timeline">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Nookure/NookTheme&type=Timeline&theme=dark" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Nookure/NookTheme&type=Timeline" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Nookure/NookTheme&type=Timeline" />
</picture>
</a>
## License
2022-10-30 19:58:29 +00:00
2023-08-06 17:34:25 +01:00
Pterodactyl® Copyright © 2015 - 2023 Dane Everitt and contributors.
> Nookure is not affiliated with Pterodactyl® Panel or its contributors.
Pterodactyl code released under the [MIT License](./LICENSE.md).
2020-08-29 23:48:57 +01:00
2023-08-06 17:34:25 +01:00
NookTheme code edits released under the [GNU GPLv3 License](./NookLicense.md).