Ticketix is installed from the installation ZIP package into a new, empty folder. A browser-based setup creates the configuration and the first administrator account.
Before you start
- Check the server requirements.
- Have the Ticketix installation ZIP on your computer. Download it from the link in your licence email. Do not use the update ZIP for a new installation, and do not upload the installation package over an existing installation.
- Create an empty MySQL database (
utf8mb4) and a database user with full rights on it. - Decide the public address, for example
https://support.example.comorhttps://support.example.com/ticketix, and make sure it works over HTTPS. - Install an authenticator app on your phone. You need it at your first sign-in.
Upload the files
- Extract the installation ZIP into the web folder of the address you chose.
- Make sure the web server user can write to the application folder and to the
storagefolder. - On Nginx, add the access rules described in the requirements. On Apache, the included
.htaccessfile does this.
Run the setup
- Open the setup page at the public address, for example
https://support.example.com/setup.php. Open it at the final address: setup saves this address asapp_url. - Fill in the fields:
| Field | What to enter |
|---|---|
| App Name | The name shown in the interface and in emails |
| Default Language | English, Türkçe or العربية |
| Storage Root | The storage folder; keep the suggested storage folder unless your host needs another path |
| Support Email | The address customers see and the default sender |
| Mail Server Host | The host name of your mail server |
| Host, Port, Database Name, Database User, Database Password | Your MySQL details, under Database (MySQL) |
| Charset, Collation | Keep utf8mb4 and utf8mb4_unicode_ci unless you have a reason to change them |
| Admin Name, Admin Email, Administrator password | The first administrator account; the password needs at least 8 characters |
- Click Install Ticketix. Setup tests the database connection, writes
config.php, creates the tables and the administrator account. - When you see Installation completed. You can now log in., click Admin Login.
Once Ticketix is installed, opening setup.php only takes you to the sign-in page. The setup screen suggests removing setup.php after installation. From Ticketix 2.0.2, the update ZIP does not contain setup.php, so a removed setup.php does not come back with an update.
The config.php file and app_url
Setup creates the permanent config.php from the config.sample.php template. It holds the database details, the secrets Ticketix generated (for the scheduled task, the health check and inbound mail) and these settings:
| Setting | Default | What it does |
|---|---|---|
app_url | The address you opened setup with | The public address used in links in emails, including links in mails that the scheduled task sends |
storage_root | The storage folder | Attachments, logs, sessions, the licence files and ai-secret.key |
auto_close_days | 7 | Days after which tickets in Pending or Answered close automatically |
invite_expiry_hours | 72 | How long a customer invitation link stays valid |
app_url is the full public address including any subfolder, without a trailing slash:
'app_url' => 'https://support.example.com/ticketix',
If you later move Ticketix to another address, change app_url in config.php. Without a correct app_url, links in mails sent by the scheduled task (for example the confirmation of a ticket created from incoming mail) cannot be opened.
Important: Never publish
config.phpand never replace it during updates. Back it up together with thestoragefolder.
Sign in for the first time
Administrators and agents must use two-factor authentication. You set it up at your first sign-in:
- Open the staff sign-in page at
/admin/(for examplehttps://support.example.com/admin/). The page is called Staff sign-in. - Enter the administrator email under Email or display name, enter the Password and click Sign in.
- Ticketix opens Set up two-factor authentication. Open your authenticator app, add an account and scan the QR code. If you cannot scan it, open Cannot scan? Enter the setup key and type the key into the app.
- Enter the Six-digit code from the app and your Current password, then click Turn on two-factor authentication.
- Ticketix shows Save your backup codes: ten one-time codes. Store them in your password manager. They are shown only once.
The setup code is valid for ten minutes. If it expires, click Create a new setup code and scan the new QR code.
From now on, every sign-in asks for a code from your authenticator app after the password. See Two-factor authentication and password reset.
After installation
- Restrict write access to the application folder to the user PHP runs as. Updates from the Updates screen need PHP to write the application files; if PHP cannot write them, update by hand with the update ZIP. The
storagefolder must stay writable. See Update Ticketix. - Back up
config.phpand thestoragefolder regularly to a place with restricted access.storage/ai-secret.keyprotects stored AI provider keys and the authenticator secrets of two-factor authentication.