---
url: /relyai-acellemail/installation.md
description: >-
  Install RelyAI for AcelleMail in four steps — upload the plugin, activate it,
  activate your license, and connect your first AI engine. No core patches
  required.
---

# Installation

RelyAI installs like any other AcelleMail plugin: you upload a zip, activate it, activate your
license, and connect an AI engine. There are **no core patches** and no SSH work — everything happens
in the AcelleMail admin. Set aside about ten minutes.

Before you start, make sure your server meets the [Requirements](/relyai-acellemail/requirements),
and have your RelyAI license key and an AI provider key handy.

## Step 1 — Upload the plugin

In the AcelleMail admin, go to **Plugins → Upload Plugin** and upload the RelyAI zip you downloaded
from your Relyweb account. AcelleMail installs it under `storage/app/plugins/relyweb/relyai/` and runs
its migrations automatically, adding the RelyAI configuration tables. You don't need to touch the
filesystem yourself.

![Uploading the RelyAI plugin](/relyai-acellemail/img/relyai-installation-upload.png)
*Plugins → Upload Plugin*

## Step 2 — Activate

Once the upload finishes, **activate** the plugin from the Plugins list. A new **RelyAI** group
appears in the AcelleMail sidebar — with Dashboard, Engines, Feature Flags, the observability
dashboards, and Settings. The AI surfaces stay dormant until you finish the next two steps.

## Step 3 — Activate your license

Open **RelyAI → Settings → License**, paste the key from your Relyweb account, and click
**Activate**. Your domain, IP, and install path are validated on activation, and the key is stored
encrypted and only ever shown masked. **AI features unlock once the license verifies as Active on
this domain.** For key types and management, see [Licensing](/relyai-acellemail/licensing).

![The License settings tab](/relyai-acellemail/img/relyai-installation-license.png)
*RelyAI → Settings → License*

## Step 4 — Connect an engine

Finally, go to **RelyAI → Settings → Engines & Keys** and add an engine: pick a **Provider**, choose
a **Model**, and paste the matching **API key** (leave the key blank for a local Ollama endpoint).
Click **Test Connection** — you should see "Connection successful" — then set the engine as your
**Default** so RelyAI knows which one to use for AI calls.

That's it: the chatbox, rewrite popover, subject suggestions and coaches are now ready to turn on. For
the full provider walkthrough, see [Connect an engine](/relyai-acellemail/guides/connect-an-engine),
then continue to [Configuration](/relyai-acellemail/configuration) to switch on the features you want.

## Related pages

* [Requirements](/relyai-acellemail/requirements)
* [Configuration](/relyai-acellemail/configuration)
* [Connect an engine](/relyai-acellemail/guides/connect-an-engine)
* [Licensing](/relyai-acellemail/licensing)
* [Settings reference](/relyai-acellemail/settings)