Skip to content

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.

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.

  • 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-smi must 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.

For an x86 server with Rocky Linux 9 or later. Installer version 4.6.0 (build ab1a6028), released on 14-10-2026.

  1. 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 curl commands 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.sha256
    sudo bash ZenithAI-Setup-4.6.0_x86_64.run

    sha256sum must print OK. The checksum is 7b4abeff76252b2b3674c0658b1cc1aba345f1897a4b359043b8abb02ea03d8c. If it doesn’t match, download the file again.

  2. Answer the questions, as listed in Questions the installer asks.

  3. Wait while it installs. A progress bar shows each step, and the full log is in /var/log/zenithai-setup.log.

  4. Open the address it prints at the end and sign in as the administrator. This starts the trial.

For an ARM64 server with Ubuntu 24.04 LTS. Installer version 4.6.0 (build ab1a6028), released on 14-10-2026.

  1. 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 curl commands 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.sha256
    sudo bash ZenithAI-Setup-4.6.0_arm64.run

    sha256sum must print OK. The checksum is 999465d444e811187f48794816d82961e6970069704928503381556468ec874a. If it doesn’t match, download the file again.

  2. Answer the questions, as listed in Questions the installer asks.

  3. Wait while it installs. A progress bar shows each step, and the full log is in /var/log/zenithai-setup.log.

  4. 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.

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.

  • 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.

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.

The installer leaves an uninstaller in the install folder. Run it as root:

Terminal window
sudo bash /opt/zenithai/uninstall.sh

It 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.

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 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)
Terminal window
curl --fail-with-body "https://dummydomain/ping"

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 = 48000
max_chars_per_message = 72000
max_file_mb = 50
max_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:

  1. Edit the number in the file.
  2. Check it: sudo -u zenithai-app python /opt/zenithai/application/app/token_limits.py --check --effective shows the values that will apply.
  3. 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.

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.