System Configuration

Configure essential system settings required for PteroCA to operate. These are fundamental settings needed before you can start selling servers.

Overview

Core Configuration covers system-level settings that define how PteroCA operates:

• General Settings: Site URL, title, locale, server lifecycle

• Security Settings: Email verification, CAPTCHA, Terms of Service

• Email Configuration: SMTP settings for notifications and renewals

• Payment Configuration: Stripe integration and currency settings

• Pterodactyl Settings: Admin panel Pterodactyl connection settings

• Pterodactyl Integration: Complete Pterodactyl Panel integration setup

Pterodactyl Integration is Required

Pterodactyl integration is required to provision servers. Without it, PteroCA can operate only as a storefront. You must configure the Pterodactyl connection before customers can purchase and receive servers.

Configuration Methods

CLI Configuration Wizard (Recommended for Initial Setup)

cd /var/www/pteroca
php bin/console pteroca:system:configure

The CLI wizard covers 13 essential settings:

• Site URL, title, and locale

• Pterodactyl URL and API key

• SMTP configuration

• Stripe payment key

• Currency settings

• Admin account creation

Admin Panel Settings (Recommended for Ongoing Management)

Access via: Admin Panel → Settings

The Admin Panel provides a comprehensive web interface for managing all 51 settings across 7 categories.

System Configuration

Essential settings for your PteroCA installation:

General Settings

• Site URL, title, and locale

• Telemetry preferences

• Automatic server deletion policy

• PHPMyAdmin integration

Security Settings

• Email verification requirements

• Google reCAPTCHA integration

• Terms of Service configuration

Email Configuration

• SMTP server and authentication

• Sender address

• Renewal notification settings

• Test SMTP connection

Payment Configuration

• Stripe API keys

• Payment methods (cards, wallets)

• Currency configuration

Pterodactyl Settings

• Pterodactyl Panel URL and API key

• SSO configuration

• Server logs integration

• Client panel redirection

Pterodactyl Integration

Complete guide to integrating PteroCA with Pterodactyl Panel:

Pterodactyl Integration Guide

This integration is required for server provisioning. The integration guide covers:

• Installing the PteroCA Pterodactyl Addon

• Configuring API access

• Setting up allowed origins

• Enabling SSO (Single Sign-On)

Quick Start

For first-time setup:

1. Run the CLI configuration wizard: php bin/console pteroca:system:configure

2. Follow the interactive prompts

3. Verify Pterodactyl connection works

4. Fine-tune additional settings via Admin Panel

For detailed Quick Start guide: Quick Start

Post-Configuration

After completing core configuration:

• ✅ Configure business settings: Business Configuration

• ✅ Set up user roles: Access & Permissions

• ✅ Customize appearance: Customization

Troubleshooting

Common configuration issues:

• Database connection errors

• Pterodactyl API connection failures

• SMTP email delivery problems

• Stripe payment gateway issues

For detailed troubleshooting, see individual configuration pages.

Related Documentation

• Quick Start Guide - Fast setup path

• Business Configuration - Products, pricing, vouchers

• Installation - Installation guides

• Advanced Topics - Scaling and security hardening