Pelinstaller

Installation

1. To get started, it's important to ensure that your machine is freshly reinstalled if you've made any changes to it beforehand.
2. Point a DNS A-Record to your machine's IP address, like panel.example.com to 192.168.53.72.
3. To download and run the installer, simply enter the following command into your terminal and follow the prompts:

bash <(curl -Ss https://raw.githubusercontent.com/Zinidia/Pelinstaller/Production/install.sh || wget -O - https://raw.githubusercontent.com/Zinidia/Pelinstaller/Production/install.sh)

Note: On some systems, it's required to be already logged in as root before executing the one-line command (where sudo is in front of the command does not work).

⚠️ Troubleshooting: If you encounter any issues during installation or while using Pelican, first check the Pelican logs and review the official Pelican Troubleshooting Guide. If you're still unable to resolve the problem, please open an issue on the PelInstaller GitHub repository and share any relevant logs.

Here is a YouTube Video that illustrates the installation process.

Features

• Automatic installation of the Pelican Panel (dependencies, database, cronjob, nginx).
• Automatic installation of the Pelican Wings (Docker, systemd).
• Panel: (optional) automatic configuration of Let's Encrypt.
• Panel: (optional) automatic configuration of firewall.
• Uninstallation support for both panel and wings.

Help and support

For help and support regarding the script itself and not the official Pelican project, create a Github Issue.

Supported installations

List of supported installation setups for panel and Wings (installations supported by this installation script).

Supported panel and wings operating systems

Operating System	Version	Supported	PHP Version
Ubuntu	16.04	🔴
	18.04	🔴 *
	20.04	✅	8.5
	22.04	✅	8.5
	24.04	✅	8.5
	26.04	✅	8.5
Debian	8	🔴 *
	9	🔴 *
	10	✅	8.5
	11	✅	8.5
	12	✅	8.5
	13	✅	8.5
CentOS	6	🔴
	7	🔴 *
	8	🔴 *
Rocky Linux	8	✅	8.5
	9	✅	8.5
	10	✅	8.5
AlmaLinux	8	✅	8.5
	9	✅	8.5
	10	✅	8.5

* Indicates an operating system and release that previously was supported by this script.

Firewall setup

The installation scripts can install and configure a firewall for you. The script will ask whether you want this or not. It is highly recommended to opt-in for the automatic firewall setup.

Production & Ops

Creating a release

In install.sh github source and script release variables should change every release. Firstly, update the CHANGELOG.md so that the release date and release tag are both displayed. No changes should be made to the changelog points themselves. Secondly, update GITHUB_SOURCE and SCRIPT_RELEASE in install.sh. Finally, you can now push a commit with the message Release vX.Y.Z. Create a release on GitHub. See this commit for reference.

Sponsors ✨

I would like to extend my sincere thanks to the following sponsors for helping fund Pelinstaller's development. Interested in becoming a sponsor?

Company	About
ForestRacks	Looking for a place to host your Pelican Panel? Try out a ForestRacks VPS, ForestRacks is a US-based 5-Star hosting provider offering services globally since 2019.

Contributors ✨

We would like to thank the following contributors for their work in maintaining and creating this installer:

1. Matthew Jacob
2. Vilhelm Prytz
3. Linux123123
4. ImGreen
5. Neon
6. sam1370
7. Linux123123
8. sinjs

Copyright (C) 2018 - 2024, Vilhelm Prytz Copyright (C) 2021 - 2026, Matthew Jacob