Start

Install on your server

You were emailed a personal installation link. On your own Linux server, one command sets up everything — the assistant, its database, and its automatic updates. There is nothing to configure and no keys to enter.

Before you start

A Linux server — Ubuntu 22.04+ or Debian 12+ recommended.
4 GB RAM or more, and a few GB of free disk.
Root access (the command uses sudo).
Outbound internet. The assistant checks in with Naxis to stay licensed, so the server must be able to reach naxistechnologies.com.
Docker is installed automatically if it isn’t already present.

Install

Open the link from your email — it shows your exact command. Run it on the server as root:

curl -fsSL https://naxistechnologies.com/install/<your-link> | sudo bash

It takes a few minutes the first time (it downloads the assistant). When it’s done it prints the address your assistant is running at.

Keep the link private Your installation link carries your licence. Don’t forward it — anyone who has it could stand up a copy of your deployment.

First run

Open the address the installer printed, in a browser.
Create your administrator account. The first person to open a fresh install becomes its admin.
Follow the setup wizard — set your organisation name, connect your first content source, and invite your team. See Using the assistant.

Give it a proper web address

Without a domain, the assistant is reachable at your server’s IP over plain HTTP — fine for a first look, not for daily use. For a stable, secure address:

Point a domain (an A record) at your server’s IP address.
Re-run the install command. The assistant obtains a free HTTPS certificate for that domain automatically.
In the assistant, open Settings and set your public address to the same domain, so links in emails and channels point to the right place.

Why the address matters The address you set is where your people reach the assistant and where invitation and reset emails point. It also lets your Naxis contact see your deployment is healthy.

What got installed

Everything lives under /opt/naxis on the server and runs in Docker:

the assistant and its background worker,
a private database (your content and its index — never leaves the server),
an updater that installs new versions in a window you choose, taking a database backup first and rolling back if anything is wrong.

You never touch these directly. Day-to-day, you only use the assistant in your browser.

The AI itself A self-hosted deployment can run a self-hosted, open-weight AI model on your own hardware, so answer generation never leaves the server either. Deployments that prefer it use the Naxis AI service instead, under a data-processing agreement with zero-retention terms; either way there is no model to configure and no API key to hold.

Re-running the installer

The command is safe to run again — it re-applies the setup in place and never touches your data or your account. Use it to move to a new domain, or if support asks you to.

Next: Using the assistant →