1. Install PHP, Nginx, MariaDB, and Dependencies
Update packages:
apk update
Install required packages:
apk add php83 php83-gd php83-mbstring php83-bcmath php83-xml php83-curl php83-zip \
php83-intl php83-fpm php83-fileinfo php83-dom php83-tokenizer php83-session \
php83-sodium php83-pdo php83-simplexml php83-pdo_sqlite php83-xmlreader \
nginx curl tar unzip composer mariadb mariadb-client
Follow the official guide: https://pelican.dev/docs/panel/getting-started/#create-directories--downloading-files
Do not run the default composer install command. Instead run:
COMPOSER_ALLOW_SUPERUSER=1 composer install --no-dev --optimize-autoloader
2. Configure Nginx
Remove the default Nginx configuration:
rm /etc/nginx/http.d/default.conf
Download and adjust the official Pelican Nginx config: https://pelican.dev/docs/panel/webserver-config/
Save it to:
/etc/nginx/http.d/pelican.conf
Comment or remove the following lines in pelican.conf:
1 | server_tokens off;
...
27| ssl_session_cache shared:SSL:10m;
Replace the unix: socket on line 47 with:
47| fastcgi_pass unix:/run/php-fpm83/php8.3-fpm.sock;
3. Configure PHP-FPM
Edit /etc/php83/php-fpm.d/www.conf and adjust:
28| user = nginx
29| group = nginx
...
41| listen = /run/php-fpm83/php8.3-fpm.sock
...
53| listen.owner = nginx
Follow the panel setup guide: https://pelican.dev/docs/panel/panel-setup/
Replace all instances of www-data with nginx.
4. Database Setup
Initialize MariaDB:
/etc/init.d/mariadb setup
Comment out line 10 in:
/etc/my.cnf.d/mariadb-server.cnf
Specifically:
skip-networking
Enable and start services:
rc-update add nginx
rc-update add php-fpm83
rc-update add mariadb
rc-service php-fpm83 start
rc-service nginx start
rc-service mariadb start
There should be no errors at this point.
Follow the MySQL guide: https://pelican.dev/docs/panel/advanced/mysql/
5. Web Installer
Open the installer:
https://yourdomain/installer
| Driver | Selection |
|---|---|
| Database | MariaDB |
| Cache | Filesystem |
Queue Driver
Copy the top command provided by the installer (not the bottom one). Again, replace any www-data occurrences with nginx.
Create the queue service file:
/etc/init.d/pelican-queue
Using the version from: https://tannerte.ch/scripts/pelican-queue
Make executable and enable on boot:
chmod +x /etc/init.d/pelican-queue
rc-update add pelican-queue
rc-service pelican-queue start
Session Driver
Choose between Filesystem and Database.
I suggest Filesystem.
6. Updating the Panel
For upgrades, follow: https://pelican.dev/docs/panel/update/
Replace any reference to www-data with nginx.
Finished!
You can now proceed to add your nodes. If there are any issues please submit an issue here