ARN Smart Support
Language: English

Install Ticketix

Updated 19 Nov 2026 5 min read

Feedback saved.

Browse Ticketix articles

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.com or https://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

  1. Extract the installation ZIP into the web folder of the address you chose.
  2. Make sure the web server user can write to the application folder and to the storage folder.
  3. On Nginx, add the access rules described in the requirements. On Apache, the included .htaccess file does this.

Run the setup

  1. 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 as app_url.
  2. Fill in the fields:
FieldWhat to enter
App NameThe name shown in the interface and in emails
Default LanguageEnglish, Türkçe or العربية
Storage RootThe storage folder; keep the suggested storage folder unless your host needs another path
Support EmailThe address customers see and the default sender
Mail Server HostThe host name of your mail server
Host, Port, Database Name, Database User, Database PasswordYour MySQL details, under Database (MySQL)
Charset, CollationKeep utf8mb4 and utf8mb4_unicode_ci unless you have a reason to change them
Admin Name, Admin Email, Administrator passwordThe first administrator account; the password needs at least 8 characters
  1. Click Install Ticketix. Setup tests the database connection, writes config.php, creates the tables and the administrator account.
  2. 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:

SettingDefaultWhat it does
app_urlThe address you opened setup withThe public address used in links in emails, including links in mails that the scheduled task sends
storage_rootThe storage folderAttachments, logs, sessions, the licence files and ai-secret.key
auto_close_days7Days after which tickets in Pending or Answered close automatically
invite_expiry_hours72How 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.php and never replace it during updates. Back it up together with the storage folder.

Sign in for the first time

Administrators and agents must use two-factor authentication. You set it up at your first sign-in:

  1. Open the staff sign-in page at /admin/ (for example https://support.example.com/admin/). The page is called Staff sign-in.
  2. Enter the administrator email under Email or display name, enter the Password and click Sign in.
  3. 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.
  4. Enter the Six-digit code from the app and your Current password, then click Turn on two-factor authentication.
  5. 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 storage folder must stay writable. See Update Ticketix.
  • Back up config.php and the storage folder regularly to a place with restricted access. storage/ai-secret.key protects stored AI provider keys and the authenticator secrets of two-factor authentication.

Next steps

On this page

Submit a ticket

Create a new support request without needing a portal account.

Priority
Attachments
Only you and our staff see a ticket. Never send passwords or licence codes.

Track a ticket

Use the ticket number and password from your confirmation email.

The number and the password are in your confirmation email.

Sign in

Access your support portal account.

New here?

Create account

Create your support portal account.

Already have an account?

Forgot password?

We email you a link to choose a new password.

Conversation

Was this helpful?
Open full article
↑ ↓ to moveEnter to openEsc to close