Roll Out Optima To Your Staff
This guide takes a working Optima installation and makes it ready for everyone in your organisation. You will give it an address people can reach without warnings, prepare Assistants for them, create accounts that open straight into the chat app, and find a way to see how it is being used.
By the end of this guide you will have staff signing in to Optima Chat in a browser, on their desktop or on their phone, with a welcome screen in your organisation's name and Assistants chosen for them.
Before You Start
You will need the following:
- Optima is installed and set up, with at least one chat model running. See Getting Started.
- You are signed in with an Admin account. Some of these settings, such as the chat app's welcome screen, are for Admin accounts only.
- Your licence covers the number of people you plan to add. See Licensing.
Checklist
The rollout is made up of eight steps. Each is covered in its own section below.
| Step | Why | |
|---|---|---|
| 1 | Give Optima a proper address and certificate | So browsers and the apps connect without warnings |
| 2 | Make sure it can serve everyone | So people are not left waiting at busy times |
| 3 | Set up email | So new accounts receive their passwords by themselves |
| 4 | Prepare assistants | So people start with something useful, set up the way you want |
| 5 | Brand the welcome screen | So it looks like your organisation's tool |
| 6 | Create accounts | So staff get the chat app, and not the administration pages |
| 7 | Tell people how to get in | One message, with the address and the apps |
| 8 | Watch how it is used | So you can adjust capacity and Assistants |
1. Give Optima A Proper Address And Certificate
People reach Optima at one address — for example, optima.example.com. Before telling anyone that address:
- Create a DNS record for it, pointing at the Gateway machine.
- Install a certificate their devices trust. A certificate from your organisation's own certificate authority is usually best, because every managed device already trusts it. In Settings → Security, click Manage Certificates and choose it from the Windows certificate store, or upload it as a PFX file. See Certificates and Security.
- Use port 443 if you can — then nobody needs to type a port. The Gateway uses 443 by default.
- Open the port in the Gateway machine's firewall, and anywhere between your staff and the Gateway. The installer opens the Gateway machine's own firewall when Allow Optima through the firewall is ticked, which it is by default. On Windows that covers Domain and Private networks; check the Gateway's card in the installer's Manage page for a warning about Public networks. See Firewall.
Check by opening https://optima.example.com in a browser on a staff device. The sign-in page should load with no warning.
Warning
With the Gateway's self-signed certificate, browsers will show a warning and the apps will ask each person to trust the server — a habit you do not want people to learn. Use it for trials only.
2. Make Sure It Can Serve Everyone
Think about how many people will be chatting at the same moment — far fewer than the number of staff. Each model answers a set number of conversations at once, and anyone beyond that waits for the next free slot.
Set each model's Requests at Once and Context Window for the number you expect. See Serve More People at Once on Two GPUs — it applies to a single GPU too.
If you have several models running, keep the ones people will not use stopped: they take memory a busier model could have.
3. Set Up Email
With email set up, a new account's temporary password will be emailed to the person, and people can reset a forgotten password themselves. Without it, you will need to pass each temporary password on by hand.
In Settings → Email, turn on Enable outbound email, enter your mail server's details, and click Send a test email. You can also change the wording of the new-account email under Templates. See Settings.
4. Prepare Assistants
An Assistant is a model with instructions, and optionally knowledge and tools, set up for a job. Have two or three ready before anyone signs in, so people start with something useful. For example:
- A general Assistant — your organisation's tone, and anything everyone should know, such as "We are Example Ltd, a UK company; use British English."
- An Assistant for the most common question, such as HR policy or IT help, answering from your own documents. See Build an Assistant That Answers From Your Documents.
For each, on its Access tab, tick Chat, click Give everyone access…, and tick Give new users access — so people who join later get it too.
Then decide whether people may also chat with models directly. Settings → Assistants → Only allow assistants limits them to the Assistants shared with them. Every conversation will then run with instructions, tools and knowledge you chose, and Connectors will reach only the people whose Assistants have them. See Settings for every assistant.
5. Brand The Welcome Screen
You can show your organisation's name and logo on the welcome screen people see when they open Optima Chat. In Settings → Chat app:
- Under Welcome message, enter a Heading, such as Welcome to Example AI, and a Line beneath it, such as Ask about policies, documents and more.
- Under Logo, upload your logo for the Light theme, and a version for the Dark theme if you have one. PNG works best. If you upload only one logo, it will be used for both themes.
Copies of Optima Chat already open will pick up the change shortly afterwards. See Chat app.
6. Create Accounts
Each member of staff needs their own account. For each person, in Settings → Users, click New User:
- Enter their name, Username and Email.
- Choose User as the User Type — not Admin.
- For staff who only need the chat app, untick Access Gateway. They will then be taken straight to Optima Chat when they sign in, and cannot reach any administration page.
- Click Create.
Warning
A new User account starts with every permission ticked, apart from Optima Connectors and Analytics. Untick Access Gateway for chat-only staff before you click Create.
The person will receive a temporary password by email, valid for 72 hours, and will choose their own when they first sign in. See Users and Permissions.
Give administration permissions only to the people who look after Optima — for example, Assistants and Knowledge Base for whoever maintains the HR Assistant and its documents.
7. Tell People How To Get In
Send one message with everything people need. For example:
Optima is ready for you.
You'll get an email with a temporary password. Then use Optima in whichever way suits you:
- In your browser — go to https://optima.example.com/OptimaChat
- On your computer — install Optima Chat from optimagpt.com/download. Click Advanced on the sign-in screen and enter
optima.example.comas the Server.- On your phone — install Optima Chat from the App Store or Google Play, and enter the same server.
Start with the General assistant, or HR Helper for policy questions.
Adjust the address, and leave out the port unless you changed it from 443. Phones and laptops away from the office can only reach Optima if your network allows it — through a VPN, for example.
See Getting the App and Signing In. The Optima Chat pages are written for staff, and can be shared with them as they are.
8. Watch How It Is Used
Once people are using Optima, you can see how it is being used and adjust it. Open Analytics from the menu after the first week or two. You will need the Analytics permission, which Admin accounts have.
| Tab | Look for |
|---|---|
| Capacity | How many people chat at once, at peak. If it often exceeds the conversations your models answer at once, people are waiting — see step 2 |
| Assistants and tools | Which Assistants people actually use, and which they ignore |
| Reliability | Requests that failed, were stopped or cut short |
| Sign-ins | Failed sign-ins — people stuck on their first password, or something trying to guess them |
Analytics never shows what anyone said. See Analytics.