Knowledge base

Step-by-step how-tos and fixes for TNS Panel: migrating from CWP, wildcard certificates, mail, backups, clusters, quotas and more. Searchable.

Getting started

How to install TNS Panel on AlmaLinux or Rocky Linux

Install TNS Panel on a clean AlmaLinux 8/9/10 or Rocky Linux 9/10 server with the signed installer, then save the one-time admin credentials.

How to sign in for the first time and keep your recovery codes

Sign in to the admin interface with the generated password and your authenticator app, and store the one-time recovery codes safely.

How to apply a license and check its status

Paste your license identifier in Panel, License, let the node validate it, and see the plan and the date it was last checked.

What happens to my node when the license expires

Sites, mail and DNS keep running. Paid features stop being created, PHP consolidates to one version and resource limits stop applying.

How to get support and open a ticket from your panel

The Free tier is self-service; Premium Support adds tickets, installation and migration help. Tickets from inside the panel are coming soon.

Migration

How to migrate from CWP to TNS Panel

Move accounts, sites, databases and mail from CentOS Web Panel to a clean TNS Panel server over SSH, with the old server serving meanwhile.

How to migrate from a cPanel, Plesk or DirectAdmin backup file

Import an account from the backup archive of the old panel when you have no SSH access to its server, as a reseller or an admin.

How to migrate one account without access to the old server

Bring a single customer from Ferozo or any closed hosting using only their FTP/SFTP, IMAP and a database export.

How to verify a migration before you change DNS

Run the read-only verification to check that every site responds, every database has its tables and mail is present, before pointing DNS at the new server.

Why were my migrated mailboxes not created?

The panel asks the real DNS where the MX points and skips local mailboxes when mail lives elsewhere, so other tenants' mail is not delivered locally.

Websites and PHP

How to add a website, an alias and a parked domain

Create a site with its own document root, add alias and parked domain names, and understand where files go and what certificates cover.

How to issue a wildcard SSL certificate

Let this node serve your DNS zone and TNS Panel issues one Let's Encrypt certificate for *.example.com and example.com through DNS-01.

How to install your own SSL certificate or generate a CSR

Generate a key and CSR for a commercial certificate, then upload the certificate, key and chain to a site.

How to enable a second PHP version for one site

Install extra PHP versions from the provider repository and choose a version per site; needs a License.

Why did my site change PHP version after I removed one?

When an installed PHP version is removed, its sites move to the nearest lower version, or the nearest higher if none is lower, and move back on reinstall.

How to install WordPress or another app with one click

Install from the closed catalog, finish the setup in the browser, and fix the 409 error that names a missing PHP extension or version.

How to deploy a site from Git and publish a staging copy

Deploy from an HTTPS repository with a token, create staging.<domain>, test, and publish the files to production without touching the database.

How to run a Node.js, Python or .NET app as a container

Create a container from a preset or any image, get a subdomain and certificate, and learn which port the app must listen on.

How to force HTTPS and enable HSTS on a site

HTTPS redirect and HSTS are on by default; change them per site, and understand why HSTS is only sent where a valid certificate exists.

How to switch between Apache, nginx and OpenLiteSpeed

Change the public edge of a node, check which one is active, and understand the automatic rollback.

Email

How to create a mailbox and use webmail

Add a mail domain, create mailboxes with quotas, set up aliases and a catch-all, and sign in to Roundcube at webmail.<domain>.

How to rotate a DKIM key without breaking mail

Use the three-step flow: prepare a new key, wait for DNS to propagate, confirm the switch, then retire the old record.

How to set up mail filters, an auto-responder and block lists

Create filters and an out-of-office reply from fixed options; the panel writes and compiles the Sieve script for you.

Why is my mail delayed, rejected or not arriving?

Check the emails-per-hour limit, the MX records, delivery tracking and DKIM to find out why a message is delayed or never arrives.

Databases

How to create a MariaDB or PostgreSQL database and user

Create a database, create a user, grant access, and open phpMyAdmin or phpPgAdmin from the panel with one click.

How to restore a database from a backup

Pick the database in a snapshot and restore it next to the original or over it; a database is always restored whole.

How to allow remote access to your database from your own IP

The admin sets the node policy; with the "registered addresses only" policy you add the IPs allowed to reach MySQL.

Backups and storage

How to restore files or a folder from a backup

Browse a snapshot, restore files next to the original or over them, or download a .tar.gz of the snapshot.

How to add your own backup destination (SFTP, S3, B2 or cloud)

Send your copies to your own SFTP, S3 or B2 storage, or to Google Drive, OneDrive, Dropbox or Box through rclone, and confirm the SFTP fingerprint.

Why do I get "quota exceeded" or "no space left"?

Distinguish disk space from file count (inodes), free what you need, and understand why uploads, restores and logs stop at the quota.

Access and accounts

How to connect with FTPS and SFTP

Use explicit FTPS with the passive port range or SFTP with your account or an SSH key, and fix a listing that hangs.

How to use the file manager and the browser terminal

Edit and move files in the browser, and open a console when your provider enabled shell access; what to do when the console is not enabled.

How to give an employee a login with limited permissions

Create a sub-user, tick the areas they may use, and remove a permission instantly when needed.

How to schedule a cron job and fix one that does not run

Create a scheduled command with a five-field schedule or @daily, and a checklist for jobs that never run.

Server and security

The firewall blocked me: how to get back in

SSH and the panel ports are never closed by the panel; remove your own ban, whitelist your address and understand brute-force bans.

What to do if you lost the admin password or second factor

Use a one-time recovery code, have another admin reset you, or create a new admin on the server.

How to update the panel safely and what rollback does

Pick a channel, search for an update, apply it only when you decide, and understand the automatic rollback if the panel does not come up.

How to send the audit log to your own syslog or SIEM

Export the audit trail off the node over verified TLS using RFC 5424 syslog, with a private CA if you need one.

How to monitor a node with Prometheus and Grafana

Create the metrics token for your own Prometheus, or install the built-in Prometheus and Grafana stack with a License.

Clusters

How to set up a two-node cluster

Found a cluster on the first node, invite the second, and understand quorum, the witness and what Multinode requires.

How to promote the secondary node in a two-node cluster

With two nodes, the license server is the witness; behind one shared public IP promotion is manual. Verify the primary is really down first.