Panel Setup

The core environment is easily configured using a single CLI command & the web installer built into the app.

This step will cover setting up things such as sessions, caching, database credentials, and email sending.

Running php artisan p:environment:setup will, if it does not exist, auto create the required .env file and generate a APP_KEY.

Want to use MySQL/ MariaDB?

Make sure to read the MySQL guide first if you want to use MySQL/ MariaDB instead of SQLite!

php artisan p:environment:setup

BACK UP APP_KEY!

Back up your encryption key (APP_KEY in the .env file). This is used as an encryption key for all data that needs to be stored securely (e.g. api keys). Store it somewhere safe - not just on your server. If you lose it all encrypted data is irrecoverable -- even if you have database backups.

Setting Permissions

The next stop in the installation process is to set the correct permissions on the Panel files so that the webserver can use them correctly.

chmod -R 755 storage/* bootstrap/cache/

NGINX/Apache

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

Rocky Linux NGINX

chown -R nginx:nginx /var/www/pelican

Rocky Linux Apache

chown -R apache:apache /var/www/pelican

Crontab Configuration

We need to create a new cronjob that runs every minute to process specific tasks, such as session cleanup and scheduled tasks. You'll want to open your crontab.

NGINX/Apache

sudo crontab -e -u www-data

Rocky Linux NGINX

sudo crontab -e -u nginx

Rocky Linux Apache

sudo crontab -e -u apache

And then paste the line below.

* * * * * php /var/www/pelican/artisan schedule:run >> /dev/null 2>&1

Setting up Queue Service

Once you install the panel and set up the cron-tab the last step to take is to set up the queue service. This can be done with the command below.

sudo php artisan p:environment:queue-service

Web-Installer

Once you've set the proper permissions & created the Cron & Queue worker, continue the Panel install on the web interface.

Located at <domain>/installer or <ip>/installer