Self-hosted

Self-hosted system requirements

System requirements for FoxDesk self-hosted: PHP 8.1+, MySQL or MariaDB, required extensions, writable paths, and background tasks.

Self-hosted

These instructions apply only to the open-source FoxDesk edition installed on infrastructure you manage.

Using FoxDesk Cloud?

None of the server, PHP, database, cron, backup, or update requirements on this page apply to FoxDesk Cloud.

Try FoxDesk Cloud

Confirm these requirements with the hosting provider before uploading a release. WordPress compatibility alone does not prove that scheduled tasks, required PHP extensions, or the necessary file permissions are available.

Server parameters

  • PHP: 8.1 minimum; 8.2 or newer recommended.
  • MySQL: 5.7 minimum; 8.0 or newer recommended.
  • MariaDB: 10.2 minimum; 10.6 or newer recommended.
  • Storage: 50 MB for the application; 200 MB or more plus capacity for uploads and backups recommended.

PHP extensions

Required: pdo_mysql, mbstring, json, openssl, and zip.

Recommended: fileinfo for reliable upload MIME detection, intl for native locale formatting and Unicode normalization, and curl for web push and migration connectivity.

Optional: imap is required only when FoxDesk should receive email and turn it into tickets.

What you need to install

To install FoxDesk, you need:

  1. A Domain or Subdomain: e.g., helpdesk.yourdomain.com
  2. File Access: FTP, SSH, or a web file manager to upload the ZIP contents.
  3. A Database: The ability to create a blank MySQL/MariaDB database and user credentials.
  4. Writable Paths: PHP must be able to create config.php during installation and write to uploads/, storage/, and backups/.
  5. Background Tasks: FoxDesk includes an authenticated-request fallback. System cron is recommended for predictable email intake, recurring tickets, and maintenance, but it is not mandatory on shared hosting.
  6. Backups: A tested method for backing up and restoring the database, configuration, and uploaded files.