Docker Installation

Guide to installing PteroCA using Docker Compose for fast and isolated deployment.

This method is ideal for both developers and production environments — ensuring consistent configuration, isolated services, and simplified updates.

We currently provide two installation paths depending on your experience and needs:

---

🧩 1. Automatic Docker Installation (Recommended)

For users who want a fully automated setup, PteroCA offers an official Bash installer that handles everything for you — from installing Docker and dependencies to running containers and configuring the environment.

This script is perfect for quick deployments or VPS environments.

👉 Guide: Automatic Docker Installation

Features:

• Detects your operating system automatically

• Installs Docker and Docker Compose (v2) if missing

• Clones the PteroCA repository

• Configures environment and secrets

• Builds and starts containers

• Displays access URLs and credentials at the end

---

⚙️ 2. Manual Docker Installation

For advanced users or CI/CD environments, you can install PteroCA manually using the included Docker configuration files.

This approach gives you full control over environment settings, ports, and volumes, while still using the official Docker Compose stack.

👉 Guide: Manual Docker Installation

Features:

• Use your existing Docker setup

• Customize environment variables and volume mappings

• Fine-tune phpMyAdmin, MySQL, and Nginx configuration

• Ideal for development or complex server setups

---

📘 Which one should I choose?

If you want...	Recommended Option
A quick and easy installation	Automatic Docker Installation
Full manual control or CI/CD deployment	Manual Docker Installation
To experiment locally on your laptop	Automatic (dev mode)
To run PteroCA in production under Docker	Automatic (prod mode)

---

🔒 Why use Docker for PteroCA?

• 🧱 Consistent environment — identical across all systems

• 🚀 Fast setup — no manual dependency management

• 🧩 Modular — separate containers for web, database, and phpMyAdmin

• 🔁 Easier updates — rebuild or restart containers instantly

• 🧼 Clean removal — no leftover files after uninstall

---

✅ Next Steps

After Docker installation, two additional steps are required for full functionality:

• Install the PteroCA Plugin for Pterodactyl

• Configure Allowed Origins in Wings

Both are covered in detail in each installation guide below.

Choose your preferred installation method below to continue:

• ⚡ Automatic Docker Installation →

• 🔧 Manual Docker Installation →

---

Getting Help

If you encounter issues with Docker installation:

1. Docker-specific checks:

   • Verify Docker is running: docker ps

   • Check container logs: docker logs pteroca_web

   • Review Installation Troubleshooting

2. Information to provide:

   • Docker version: docker --version

   • Docker Compose version: docker-compose --version

   • Container status: docker ps -a

   • Container logs output

3. Get support:

   • Discord: Join our Discord community for Docker help

   • GitHub: Open an issue on GitHub