Installation

Requirements

Operating system and software requirements for Southactyl.

Requirements

Supported operating systems

Recommended targets:

OSVersionNotes
Ubuntu22.04, 24.04Ubuntu 22.04 usually needs an external PHP repository
Debian11, 12, 13Debian may require Sury PHP packages
Rocky / Alma / RHEL8, 9Package names, users, and Redis service names differ

The command examples in this documentation target Ubuntu.

Required software

Southactyl needs:

  • PHP 8.2 or 8.3
  • MySQL 8+ or MariaDB 10.2+
  • Redis
  • Composer v2
  • Web server:
    • NGINX
    • Apache
    • Caddy
  • curl
  • tar
  • unzip
  • git

PHP extensions

Install these PHP extensions:

  • cli
  • openssl
  • gd
  • mysql
  • pdo
  • mbstring
  • tokenizer
  • bcmath
  • xml / dom
  • curl
  • zip
  • fpm

Use:

  • HTTPS only
  • Redis for cache, sessions, and queue
  • A local database bound to 127.0.0.1
  • A dedicated database user
  • A backed-up .env file
  • A backed-up APP_KEY

Losing APP_KEY is not a small mistake. Encrypted data such as API keys may become unrecoverable.

Copyright © 2026