Install ZenithAI on your server
ZenithAI comes as a single-file installer that you download and run yourself. It sets up the full product on your server, with web search and reading of scanned documents, and starts a 30-day free trial with no limit on users. There is one installer for an x86 server and one for an ARM64 server, both version 4.6.0.
Download
Section titled “Download”| Server | Version | Released |
|---|---|---|
| x86 | 4.6.0 (build ab1a6028) |
14-10-2026 |
| ARM64 | 4.6.0 (build ab1a6028) |
14-10-2026 |
Get the installer on the ZenithAI download page. Fill in a short form with your name, organisation and work email, and the download links for both files appear on that page.
| Server | Operating system | Installer | Checksum file |
|---|---|---|---|
| x86 (Intel or AMD, 64-bit) | Rocky Linux 9 or later | ZenithAI-Setup-4.6.0_x86_64.run (about 243 MB) |
ZenithAI-Setup-4.6.0_x86_64.run.sha256 |
| ARM64 (aarch64) | Ubuntu 24.04 LTS | ZenithAI-Setup-4.6.0_arm64.run (about 236 MB) |
ZenithAI-Setup-4.6.0_arm64.run.sha256 |
The x86 installer also runs on Red Hat Enterprise Linux and AlmaLinux, version 9 or later. Each installer checks the server first and stops if it is the wrong one for that server.
Both installers are trial versions that run for one month.
Version 4.6.0 adds ZenithAI Agents (CSV to Dashboard, Designer and Note Taker), the Responses API, function calling on Fast, functions that return images, and the Top 10 by usage card, on both kinds of server. A server on an older installer gets them when it is updated to 4.6.0; see Update to a newer version and the changelog.
What your IT team prepares
Section titled “What your IT team prepares”- A server that meets the hardware minimum, with one of the operating systems above.
- Administrator (root) access on that server.
- A working NVIDIA driver:
nvidia-smimust list your graphics cards. Use driver version 580 or newer. If Secure Boot is on, the driver must be a signed one. - Internet access during setup. The installer downloads system packages and the AI models.
- Ports 80 and 443 open to your users.
- At least 40 GB of free disk space in the install folder. Plan for about 80 GB with all four tiers.
- The email address of your first administrator, and your organisation’s name for the licence.
- A domain name for your users, if you want one. Without it, people open the server’s IP address.
You don’t need to install a database or a web server first. The installer sets them up.
Install on an x86 server
Section titled “Install on an x86 server”For an x86 server with Rocky Linux 9 or later. Installer version 4.6.0 (build ab1a6028),
released on 14-10-2026.
-
Get the installer and its checksum file from the download page and put both in the same folder on the server. The page also gives ready
curlcommands to fetch them from the server itself. Then check the file and run it as root:Terminal window sha256sum -c ZenithAI-Setup-4.6.0_x86_64.run.sha256sudo bash ZenithAI-Setup-4.6.0_x86_64.runsha256summust print OK. The checksum is7b4abeff76252b2b3674c0658b1cc1aba345f1897a4b359043b8abb02ea03d8c. If it doesn’t match, download the file again. -
Answer the questions, as listed in Questions the installer asks.
-
Wait while it installs. A progress bar shows each step, and the full log is in
/var/log/zenithai-setup.log. -
Open the address it prints at the end and sign in as the administrator. This starts the trial.
Install on an ARM64 server
Section titled “Install on an ARM64 server”For an ARM64 server with Ubuntu 24.04 LTS. Installer version 4.6.0
(build ab1a6028), released on 14-10-2026.
-
Get the installer and its checksum file from the download page and put both in the same folder on the server. The page also gives ready
curlcommands to fetch them from the server itself. Then check the file and run it as root:Terminal window sha256sum -c ZenithAI-Setup-4.6.0_arm64.run.sha256sudo bash ZenithAI-Setup-4.6.0_arm64.runsha256summust print OK. The checksum is999465d444e811187f48794816d82961e6970069704928503381556468ec874a. If it doesn’t match, download the file again. -
Answer the questions, as listed in Questions the installer asks.
-
Wait while it installs. A progress bar shows each step, and the full log is in
/var/log/zenithai-setup.log. -
Open the address it prints at the end and sign in as the administrator. This starts the trial.
On Ubuntu the installer switches the ufw firewall on and opens SSH, HTTP and HTTPS in it.
Questions the installer asks
Section titled “Questions the installer asks”The installer first shows what it found on the server: processor, memory, disks and graphics cards, and the tiers they can hold. Then it asks for:
- the folder to install in (press Enter for the default,
/opt/zenithai), - the domain name users will open, or nothing to use the server’s IP address,
- the HTTPS certificate: a self-signed one made now, your own certificate files, or a free Let’s Encrypt certificate (this needs a public domain name and port 80),
- the administrator’s email,
- your organisation’s name, which goes into the licence,
- whether to install document recognition for scanned PDFs and photos (yes by default).
It shows a summary and asks once more before it changes anything. On a server with two graphics cards it also shows which tier goes on which card, and you can change that.
What the installer sets up
Section titled “What the installer sets up”- The ZenithAI application, listening only inside the server. Nobody can reach it except through the web server.
- The AI models for the tiers your graphics cards can hold. See Hardware.
- A PostgreSQL database on the same server.
- The web server with HTTPS (TLS 1.2 and 1.3), with plain HTTP sent on to HTTPS. Uploads of up to 1 GB are allowed.
- Web search, document recognition and the tools that make and preview Office files.
- ZenithAI Agents, switched on, with Note Taker: its database tables and the voice models that tell speakers apart.
- The licence, linked to this server. The 30-day trial starts at the administrator’s first sign-in.
Update to a newer version
Section titled “Update to a newer version”Download the newer installer and run it the same way, on either kind of server. It finds the existing installation and updates it. Your data, chats, accounts, AI models and licence are kept. If newer system packages are available, it lists them and asks before it upgrades them.
Remove ZenithAI
Section titled “Remove ZenithAI”The installer leaves an uninstaller in the install folder. Run it as root:
sudo bash /opt/zenithai/uninstall.shIt shows a menu where you choose what to remove. Two options skip the menu:
| Option | What it removes |
|---|---|
--programs |
The programs and services. It keeps your data: AI models, database, user data and settings |
--purge |
Everything, data included. It asks you to type DELETE first |
System packages such as the database and the web server are never removed. The licence record also stays, so installing again on the same server continues the same trial and doesn’t start a new one.
First sign-in
Section titled “First sign-in”The first administrator signs in with the email given during installation and sets their password. This also starts the 30-day free trial. From there, the administrator creates everyone else’s accounts; see Users and admin.
Check that it is healthy
Section titled “Check that it is healthy”| Check | Who can call it | What it tells you |
|---|---|---|
/ping |
Anyone, no sign-in | The application is up |
/health |
Signed-in users or API keys | The application can reach its AI models |
/health/models?probe=1 |
Signed-in users or API keys | The models are loaded and ready (HTTP 503 if not) |
curl --fail-with-body "https://dummydomain/ping"Change chat attachment limits
Section titled “Change chat attachment limits”How much of an attached file chat reads is set in one small settings file, so you can change it without an
update. With the default install folder, the file is /opt/zenithai/application/app/token-limits.cfg:
[attachments]max_chars_per_file = 48000max_chars_per_message = 72000max_file_mb = 50max_pdf_pages = 200| Setting | Default | What it controls | You can |
|---|---|---|---|
max_chars_per_file |
48000 | Characters read from one document | Lower it to 5,000, or raise it as far as the model’s context allows (66,000 on today’s tiers) |
max_chars_per_message |
72000 | Characters read from all documents in one message | Lower it, down to the per-file value |
max_file_mb |
50 | Largest document file, in MB | Lower it only, from 1 to 50 |
max_pdf_pages |
200 | Most pages read from one PDF | Lower it only, from 1 to 200 |
To change a limit:
- Edit the number in the file.
- Check it:
sudo -u zenithai-app python /opt/zenithai/application/app/token_limits.py --check --effectiveshows the values that will apply. - Restart the app when nobody is busy:
sudo systemctl restart zenithai-app.
A setting with a wrong value falls back to its default and the others still apply. If the file is missing, all
defaults apply. People see the effective limits in the app’s help, which says set by your administrator
instead of a fixed number. A file over the size limit is refused with HTTP 413 and attachment_too_large;
text over the character limits is cut, and the answer says how much was read.
Backups
Section titled “Backups”Back up three things regularly, to a different machine: the application data folder, the settings folder, and the PostgreSQL database.
Common questions
Where do I download the ZenithAI installer?
From the download page on zenithai.data.in, after a short form with your name, organisation and work email. There is one single-file installer for an x86 server with Rocky Linux 9 or later and one for an ARM64 server with Ubuntu 24.04 LTS. Each has a checksum file, so you can confirm the download before you run it.
Can the ZenithAI installer upgrade an existing installation?
Yes. Run the newer installer the same way, on an x86 or an ARM64 server. It finds the existing installation and keeps your data, chats, accounts, AI models and licence.
Does the ZenithAI installer need a database or a web server installed first?
No. The installer sets up the PostgreSQL database, the web server with HTTPS, the AI models and the application itself. Your IT team provides the server, the NVIDIA driver and internet access during setup.
How do I check that ZenithAI is running?
Open your server address followed by /ping. It answers without sign-in and shows that the application is up. The detailed health checks at /health need you to be signed in or to use an API key.
Which database does ZenithAI use?
ZenithAI keeps its data in a PostgreSQL database on your server, which the installer sets up. Include the database in your regular backups along with the application's data and settings folders.
