Preparing your server · TMKAN

Legal Center

License Terms

Service Plans

What's new

Preparing your server

What your hosting needs, and how to set it up: PHP, the system’s folder, its address, SSL and the scheduled task.

TMKAN runs on ordinary web hosting: check what it needs, then set it up.

Before you start

The address you will keep, such as office.example.com: your licence stays tied to it.

What your hosting needs

AddressA domain or subdomain of its own, with SSL (HTTPS)

PHP8.3.36+, 8.4.27+ or 8.5.12+

PHP extensionsPDO, PDO MySQL, OpenSSL, Mbstring, BCMath, JSON, Ctype, Tokenizer, FileInfo, cURL, Sodium, XML, GD, Zip

DatabaseMariaDB 10.6 or newer

Disk500 MB free

InternetAccess to TMKAN’s server

Set it up

hPanel: PHP Configuration, choose 8.3, 8.4 or 8.5 and press Update, then tick the extensions under PHP extensions and press Save.

cPanel: MultiPHP Manager or Select PHP Version.

The PHP extensions in hPanel

Download. In the customer portal, open Downloads and press Download. The file starts with tmkan-solution.

Downloads in the portal

Upload. In File Manager, upload the file to public_html and extract it. Rename tmkan-solution to tmkan, delete the ZIP, and change nothing inside.

The folder tmkan in public_html

Address. Point it at tmkan/public.

hPanel: Domains › Subdomains, tick Custom folder for subdomain, type tmkan/public and press Create.

cPanel: Domains › Create A New Domain, untick Share document root, type public_html/tmkan/public in Document Root and press Submit.

The new subdomain in hPanel

SSL. Wait until the certificate is Active.

hPanel: Security › SSL.

cPanel: SSL/TLS Status.

The certificate, Active

Add the scheduled task

It closes each day and takes the nightly backup.

Upload tmkan-cron.sh from tmkan/server-setup to your home folder, the one holding public_html.

Add a cron job that runs every minute.

hPanel: Advanced › Cron Jobs, Custom.

cPanel: Cron Jobs, Once Per Minute.

Its command:

Put your home folder for /home/USER, and your PHP’s path after TMKAN_PHP (Hostinger’s PHP 8.5 is shown). Without it, the task may run on an older PHP and fail.

The cron job in hPanel

Special cases

A main domain that must stay on public_html? Extract the folder’s contents straight into it, instead of steps 3 and 4.

Several sites in one account? Add TMKAN_ROOT=/home/USER/domains/YOUR-SITE/public_html after /usr/bin/env (for a system in public_html itself, the folder above it).

The panel refuses the line? Put it under #!/bin/bash in tmkan-cron-line.sh in your home folder, and give the panel /bin/bash /home/USER/tmkan-cron-line.sh.

Hostinger or other CloudLinux hosting, once: create php.d/tmkan-sodium.ini in your home folder, holding extension=sodium.so.

Good to know

The wizard’s first step, Server Environment, checks PHP and its extensions. Fix every red line; yellow is only a warning.

Server Environment, all green

Minutes after the install, System Health’s Automatic jobs card shows whether the task runs. A failure is written to tmkan-cron.log.