Installation

You receive one file, pawstatus-1.0.0.pteroext. There are two ways to install it.

From the panel (easiest)

Unzip the download on your computer.
In the panel go to Admin > Extensions and press Install.
Choose pawstatus-1.0.0.pteroext, tick Enable after install and press Install.
Open https://your-panel/status. Every node is already on the page, with no setup.

From the command line

Upload pawstatus-1.0.0.pteroext to the panel server.

From the panel directory:

bash

php artisan p:extension:install /path/to/pawstatus-1.0.0.pteroext --enable
php artisan queue:restart

--enable publishes the interface and creates the database tables.

After installing by either method, run php artisan queue:restart once so emails and webhooks use the new code.

Check that it works

https://your-panel/status opens and lists your nodes.
Admin > Status Page appears in the admin menu.
php artisan schedule:list shows pawstatus:check running every minute.

Press Check now in Admin > Status Page at any time to run a round of checks right away.

If the web installer shows an error

"An unexpected error was encountered" almost always means the panel files belong to the wrong user. It happens when something was installed before with artisan as root. Give the files back to your web server user and try again:

kotlin

chown -R www-data:www-data /var/www/pterodactyl

Replace www-data and the path with your own. Some servers use nginx or apache.

Updating

Install the new .pteroext over the old one. In the panel, the installer warns that it will replace the installed version and asks you to confirm. From the command line, add --replace. Then run php artisan queue:restart. Your components, incidents and settings are kept.

Uninstalling

arduino

php artisan p:extension:remove pawstatus

This leaves the ext_pawstatus_* database tables and the extension's settings in place on purpose, so you do not lose your history by accident. Drop them by hand if you no longer want it.

Previous: Requirements · Next: Components