# Overview

The Commands section serves as a detailed reference for administrators and advanced users to efficiently manage and configure the PteroCA panel through the command-line interface (CLI). Each command is designed to perform a specific action, such as managing configurations, maintaining system health, managing plugins, or troubleshooting issues.

## Command Naming in v0.6+

Starting with **PteroCA v0.6**, all CLI commands use the `pteroca:` namespace with hierarchical organization (e.g., `pteroca:user:create`, `pteroca:plugin:enable`).

**Deprecation Timeline:**

* **v0.6** (Current): New names available with aliases. Old names show deprecation warnings
* **v0.7-v0.9**: Old names continue to work with warnings
* **v1.0.0**: Old names removed completely ⚠️

**Action Required:** Update your scripts and cron jobs to use new command names before upgrading to v1.0.0.

## Command Categories

1. [User Management Commands](/for-developers/cli-reference/user-management.md) - Create and manage user accounts
2. [Server Management Commands](/for-developers/cli-reference/server-management.md) - Sync, suspend, and delete servers
3. [System Configuration & Maintenance Commands](/for-developers/cli-reference/system-commands.md) - Configure and maintain the system
4. [Data Operations Commands](/for-developers/cli-reference/data-operations.md) - Data synchronization and migration
5. [Plugin Management Commands](/for-developers/cli-reference/plugin-commands.md) - Complete plugin management system
6. [Cron Scheduler Command](/for-developers/cli-reference/cron-scheduler.md) - Automated task scheduling
7. [Development Tools Commands](/for-developers/cli-reference/dev-tools.md) - Developer utilities
8. [Theme Commands](/for-developers/cli-reference/theme-commands.md) - List, activate, and reset themes

## Getting Help

### Command Help

Get detailed help for any command using the `--help` flag:

```bash
# Get help for specific command
php bin/console pteroca:user:create --help
php bin/console pteroca:plugin:enable --help
php bin/console pteroca:system:update --help
```

### List All Commands

List all available commands or filter by category:

```bash
# List all pteroca commands
php bin/console list pteroca

# List commands by category
php bin/console list pteroca:user
php bin/console list pteroca:server
php bin/console list pteroca:plugin
php bin/console list pteroca:system
php bin/console list pteroca:data
php bin/console list pteroca:dev
php bin/console list pteroca:cron
php bin/console list pteroca:theme
```

## Command Migration Guide

If you're upgrading from an earlier version of PteroCA, here's a quick reference for updating your scripts:

### Common Command Migrations

```bash
# User Management
app:create-new-user           → pteroca:user:create
app:change-user-password      → pteroca:user:change-password

# Server Management
app:suspend-unpaid-servers    → pteroca:server:suspend-unpaid
app:delete-inactive-servers   → pteroca:server:delete-inactive
pteroca:sync-servers          → pteroca:server:sync

# System
app:configure-database        → pteroca:system:configure-database
app:configure-system          → pteroca:system:configure
app:update-system             → pteroca:system:update
app:delete-old-logs           → pteroca:system:cleanup-logs
app:cleanup-purchase-tokens   → pteroca:system:cleanup-tokens

# Cron Scheduler (IMPORTANT!)
app:cron-job-schedule         → pteroca:cron:schedule

# Data Operations
app:synchronize-data          → pteroca:data:sync
pterodactyl:migrate-servers   → pteroca:data:migrate-servers

# Development
app:show-missing-translations → pteroca:dev:check-translations
make:theme                    → pteroca:dev:make-theme

# Theme Management
theme:list                    → pteroca:theme:list
theme:set                     → pteroca:theme:set
theme:reset                   → pteroca:theme:reset

# Plugin Management (all new commands)
plugin:*                      → pteroca:plugin:*
```

### Update Your Crontab

**Before (v0.5.x):**

```bash
* * * * * php /var/www/pteroca/bin/console app:cron-job-schedule >> /dev/null 2>&1
```

**After (v0.6+):**

```bash
* * * * * php /var/www/pteroca/bin/console pteroca:cron:schedule >> /dev/null 2>&1
```

### Update Your Scripts

**Before:**

```bash
#!/bin/bash
php bin/console app:suspend-unpaid-servers
php bin/console app:delete-inactive-servers
php bin/console plugin:cron:run
```

**After:**

```bash
#!/bin/bash
php bin/console pteroca:server:suspend-unpaid
php bin/console pteroca:server:delete-inactive
php bin/console pteroca:plugin:cron:run
```

## Running Commands

All commands should be run from the root directory of your PteroCA installation:

```bash
# Docker environment (recommended)
php bin/console <command>

# Direct execution (if not using Docker)
php bin/console <command>
```

## Additional Resources

* [Command Migration Guide](https://github.com/PteroCA-Org/panel/blob/develop/docs/COMMAND_MIGRATION_GUIDE.md) - Full migration details
* [Crontab Configuration](https://github.com/PteroCA-Org/pteroca-homepage/blob/docs/installation/installation/manual-installation/README.md#crontab-configuration) - Automation setup
* [System Configuration](/core-configuration/core-configuration.md) - Initial setup via CLI


---

# 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/for-developers/cli-reference/cli-reference.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.