Overview

Get started

Install Eldric on hardware you control, then browse to the chat. Pre-built packages — no build from source, no cloud account, no GPU required.

Requirements

Fedora 43 or Fedora 44, on x86_64 or aarch64; the GPU package is built for Fedora 43 on x86_64. Fedora 42 and RHEL-family systems (RHEL, CentOS Stream, Rocky, Alma) are not supported at the moment: each release has its own library versions, so a package built for one does not install on another.
A CPU is enough — a GPU only makes inference faster. It runs from a single box up to a cluster.
Root (or sudo) on the target host.

Install

The bootstrap script adds the repo, installs the package and enables the service:

curl -fsSL https://repo.eldric.ai/install-eldric.sh | sudo bash

Or add the repo and install the package yourself:

curl -fsSL https://repo.eldric.ai/install.sh | sudo bash
sudo dnf install eldric-aios

GPU hosts On a GPU node, install eldric-aios-cuda for CUDA acceleration. The CPU package runs everywhere; the CUDA package adds GPU inference.

At the end of the bootstrap script The script finishes by handing off to the first-run step, which in this release has to be run interactively. You will see it stop with a message about non-interactive setup. The repo, the package and the service are installed and running at that point — carry on with First run below.

First run

Do these in order. The first admin account is created in the chat, and the admin console only lets you in with that account.

Create the first admin in the chat. Browse to https://<host>/chat. On a fresh install the chat notices that no admin exists yet and offers to register the first administrator instead of showing a login. The account you register there becomes the admin. This is the step that creates your login. Do it before anyone else can reach the node: until the first account exists, authentication is off, so that this account can be created at all. It switches on by itself once the account exists.
Sign in to the admin console. There is no login for it until step 1 is done; details in the admin guide, Day 1. Browse to https://<host>/admin and sign in with the account from step 1. From here you manage tenants, users, roles, storage and upgrades.
Install a license (optional). Without one, Eldric runs on the free tier. To install a license file, run the interactive first-run step and give it the path to your enterprise_license.json:
```
sudo eldric setup --interactive
sudo systemctl restart eldric-aios
```
The step also asks for an admin email, a password and a default tenant name. Those answers do not create a login or a tenant. Your login comes from step 1, and tenants are created in the admin console. Only the license is used. It is copied to /etc/eldric/enterprise_license.json, where the service reads it after the restart.

Next steps

Call the API — the OpenAI-compatible endpoint plus the /api/v1 surface.
Use RAG — point Eldric at your own documents.
Operate a cluster — tenants, roles, storage, upgrades, from the admin console at /admin.
Troubleshooting — if something doesn't come up.