FoxDesk Logo FoxDesk

Frequently Asked Questions

Everything you need to know about installing, operating, and extending FoxDesk.

General & Pricing

Is FoxDesk really free?
Yes, FoxDesk is proudly open-source software distributed under the AGPLv3 license. It is 100% free to download, install, and modify, with absolutely no per-user limits, hidden paywalls, or feature locking.
Can I use it for internal IT support?
Absolutely. FoxDesk was originally built for B2B client support, but its permission structure makes it an excellent internal IT helpdesk. You can create an organization for your internal team and assign users.
What languages are supported?
FoxDesk natively includes full translations for English, Czech (čeština), German (Deutsch), Spanish (español), and Italian (italiano). Users can select their preferred language independently of the system default.

Installation & Hosting

How difficult is it to install?
Installation takes about 5 minutes. You download a ZIP file, upload it to your web server (via FTP or cPanel), navigate to your domain, and run a WordPress-style graphical wizard. No Composer, Node.js, or root SSH access is required.
What are the server requirements?
Wherever WordPress runs, FoxDesk will run. It's built to be extremely lightweight with minimal dependencies. You just need PHP 8.0+ and a MySQL/MariaDB database to run smoothly even on standard shared hosting.
Is there a Docker version available?
Yes, an official docker-compose setup is included in the repository. Running docker compose up -d spins up the app container alongside an optimized MariaDB 10.11 database with persistent volumes.

Features & Capabilities

Does it support email-to-ticket ingestion?
Yes. By configuring your IMAP credentials in the system, FoxDesk runs a background cron job that fetches incoming emails and automatically creates tickets or appends replies to existing active tickets.
Can I track billable time and agent costs?
Yes. Every ticket includes a built-in live stopwatch. Agents can track time, mark it as billable or non-billable, and FoxDesk calculates total time, generated revenue (based on client rates), and internal agent costs.
Can FoxDesk automatically generate recurring tickets?
Yes. The 'Recurring Tasks' feature allows you to define templates that automatically spin up new tickets on a daily, weekly, monthly, or yearly basis—perfect for routine server maintenance, backups, or audits.

Technical & API

How do updates work? Will I lose data?
FoxDesk features a built-in one-click updater. You upload the new version's ZIP file via the Admin panel. The system automatically backs up existing files, applies the patch, and safely migrates database schemas without data loss.
Is there an API available for my custom apps?
Yes. FoxDesk includes a robust REST API authenticated via Bearer tokens. You can programmatically create tickets, append comments, log time, and list statuses securely via standard JSON endpoints.
Can I integrate AI Agents into the platform?
Yes. In the Admin panel, you can generate special 'AI Agent' system accounts with API tokens. Your external scripts (like a Python bot evaluating incident severity) can post updates and resolutions using the POST /api/agent-add-comment endpoint.

Still have questions?

Our documentation contains deep dives into architecture, deployment configurations, API endpoints, and time-tracking matrix variables.