Frequently Asked Questions
Frequently asked questions about FoxDesk. Learn about pricing, installation, features, API access, and the AGPLv3 open-source license.
Short answers to common questions about the self-hosted edition.
General & Pricing
Is FoxDesk really free?
FoxDesk is distributed under the AGPL-3.0 license. The application does not charge a per-agent license fee. Hosting and operating costs remain the responsibility of the server operator.
Can I use it for internal IT support?
Yes. You can create an organization for internal users and route requests through the portal or email. Check the available permission model against your requirements before deployment.
What languages are supported?
The release contains 24 locale catalogs. English, Czech, German, Spanish, and Italian are stable. The other 19 languages are available as beta until their native-speaker and specialist review is complete. Users can select a language in their profile.
Installation & Hosting
How difficult is it to install?
Download the release ZIP, upload the files, create a database, and open install.php. The time required depends on the hosting control panel and whether the domain, database, and TLS certificate are already configured.
What are the server requirements?
FoxDesk requires PHP 8.1 or newer, MySQL 5.7 or newer or MariaDB 10.2 or newer, and the PHP extensions listed in the installation guide. Shared hosting must allow the required writable paths. System cron is recommended, but the built-in background-task fallback works on authenticated page requests.
Features & Capabilities
Does it support email-to-ticket ingestion?
Yes. A scheduled task can fetch a configured IMAP mailbox and create tickets or append replies.
Can I track billable time and agent costs?
Yes. Agents can use a timer or add minutes manually. Time entries can be billable or non-billable and can use organization and user rates in reports.
Can FoxDesk automatically generate recurring tickets?
Yes. A recurring ticket template can run daily, weekly, monthly, or yearly.
Technical & API
How do updates work? Will I lose data?
The admin updater accepts a release package and creates a backup before applying files and database migrations. Read the release notes and keep an independent server backup before upgrading.
Is there an API available for my custom apps?
Yes. The Agent API uses scoped Bearer tokens and the token owner’s permissions.
It can inspect and create tickets, add public or internal updates, change
status, record standalone or linked time, and prepare structured work logs.
Load agent-docs and then agent-me at the start of each integration session.
Can I integrate AI Agents into the platform?
Yes. Create a dedicated agent or scoped user token for each external script.
Use the canonical
POST index.php?page=api&action=agent-add-update route for a comment-only
update, and send a unique Idempotency-Key on every write.
Still have questions?
If the answer is not documented, open a GitHub discussion or issue.