# 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

{% hint style="warning" %}
**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.
{% endhint %}

## Configuration Methods

### CLI Configuration Wizard (Recommended for Initial Setup)

```bash
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](/core-configuration/core-configuration/general-settings.md)

* Site URL, title, and locale
* Telemetry preferences
* Automatic server deletion policy
* PHPMyAdmin integration

### [Security Settings](/core-configuration/core-configuration/security-settings.md)

* Email verification requirements
* Google reCAPTCHA integration
* Terms of Service configuration

### [Email Configuration](/core-configuration/core-configuration/email-configuration.md)

* SMTP server and authentication
* Sender address
* Renewal notification settings
* Test SMTP connection

### [Payment Configuration](/core-configuration/core-configuration/payment-configuration.md)

* Stripe API keys
* Payment methods (cards, wallets)
* Currency configuration

### [Pterodactyl Settings](/core-configuration/core-configuration/pterodactyl-settings.md)

* 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](/core-configuration/pterodactyl-integration.md)

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](/quick-start/quick-start.md)

## Post-Configuration

After completing core configuration:

* ✅ Configure business settings: [Business Configuration](/business-configuration/business-configuration.md)
* ✅ Set up user roles: [Access & Permissions](/access-and-permissions/access-control.md)
* ✅ Customize appearance: [Customization](/customization-and-extensions/customization.md)

## 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](/quick-start/quick-start.md) - Fast setup path
* [Business Configuration](/business-configuration/business-configuration.md) - Products, pricing, vouchers
* [Installation](/installation/installation.md) - Installation guides
* [Advanced Topics](/advanced-topics/advanced.md) - Scaling and security hardening


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pteroca.com/core-configuration/core-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.