Automatic Installation
Guide to installing PteroCA using an automated Bash script that downloads and configures all required components.
Please note, this project is currently in an early version (0.x.x) and may contain bugs. Use it at your own risk.
To facilitate a seamless installation experience, we've developed an automated Bash installer that streamlines the entire setup process. It automatically detects your operating system, installs all required dependencies, configures your environment, and deploys the PteroCA panel with minimal user input.
Additionally, the installer now offers optional Pterodactyl Panel installation — fully automated, including default node creation, API key generation, and automatic integration with PteroCA. This allows you to set up a complete, production-ready environment in a single run.
🎥 Video Guide
1. Execute the installer
💡 Now supports all-in-one setup! The installer can now automatically install PteroCA and (optionally) the Pterodactyl Panel in a single run. It will also fully configure Pterodactyl automatically – including creating the default node, generating the API key, and importing both into PteroCA for instant integration.
bash -c "$(wget -qO- https://pteroca.com/installer.sh)"
1.1 Using Installer with Custom Parameters
If you prefer to run the installer manually or automate deployments (e.g. with Ansible, CI/CD, or VPS provisioning scripts), the Bash script supports advanced flags that allow full control over the installation process.
2. Automatic Installation Process
The script will guide you through the PteroCA installation process, allowing you to choose between two configuration methods:
Web Wizard – A user-friendly web-based setup wizard that simplifies the configuration process.
CLI Wizard – A fully interactive command-line setup for users who prefer a terminal-based approach.
Both methods will prompt you to enter essential details, including PHP version selection, domain configuration, Pterodactyl API credentials, and admin account credentials for PteroCA.
Based on your inputs, the script will:
Install Dependencies: Set up necessary repositories and install required packages, including Nginx, PHP and MariaDB.
Configure Services: Set up and secure the database, configure the web server, and ensure all services are running correctly.
Deploy PteroCA: Download the latest version of PteroCA, configure environment settings, and set appropriate file permissions.
Upon successful installation, the script will provide: Access URL, Admin Credentials and Database Credentials.
Last updated