Getting Started
Pelican Panel is designed to run on your webserver.
You are expected to read through our documentation. We have spent a lot of time curating these docs for the community, so please take some time to read through them before asking for help on the forums!
You should have some basic familiarity with Linux before you proceed!
Pelican is currently in Beta! Some things might change / break between beta versions!
Picking an Operating System (OS)
Pelican runs on a wide range of operating systems, so pick whichever you are most comfortable using. Note: Other OS's, not listed below, might still work.
OpenVZ, unless specifically configured, will not work with Pelican.
| Operating System | Version | Supported | Notes |
|---|---|---|---|
| Ubuntu | 20.04 | ⚠️︎ | No SQLite Support, Ubuntu 20.04 EoL is April 2025, not recommended |
| 22.04 | ✅︎ | ||
| 24.04 | ✅︎ | Documentation written assuming Ubuntu 24.04 as the base OS. | |
| Rocky Linux | 9 | ✅︎ | |
| Debian | 11 | ⚠️ | No SQLite Support |
| 12 | ✅︎ |
SQLite support depends on libsqlite3-0_3.35+ being on the host system. Ubuntu 20.04 & Debian 11 do not meet this requirement.
Dependencies
For the Panel you need to install PHP 8.3 (recommended) or 8.2, with the following extensions:
gd, mysql, mbstring, bcmath, xml, curl, zip, intl, sqlite3 and fpm.
You will also need a Webserver. Currently, Apache, NGINX or Caddy are supported.
If you want to use MySQL or MariaDB for the panel database make sure to install either MySQL 8+ or MariaDB 10.6+. (both client and server!)
Finally, for some commands during the installation you need curl, tar and unzip.
Please make sure you installed all needed dependencies before continuing!
Create Directories & Downloading Files
The first step in this process is to create the folder where the panel will live and then move ourselves into that newly created folder.
mkdir -p /var/www/pelican
cd /var/www/pelican
Once you have created a new directory to use and moved into it, you'll need to download the Panel files.
This is as simple as using curl to download the latest release.
curl -L https://github.com/pelican-dev/panel/releases/latest/download/panel.tar.gz | sudo tar -xzv
Install Composer
Next we will set up Composer along with the required dependencies.
curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer
sudo composer install --no-dev --optimize-autoloader
Even though composer might tell you that you have outdated dependencies, do not run composer update!