Prepare your environment
The quick start ends with a bot answering in Mattermost and its work visible in the Orpheus web interface.
Install the tools
On a computer or Linux server, install Docker with Compose, Git and Python 3. Check:
docker version
docker compose version
git --version
python3 --versionDocker must be running. Use Docker Desktop on a workstation or Docker Engine with the Compose plugin on a server. Use Compose 2.24 or newer.
Prepare the services
- Create an AgentBox project and obtain an API key. Build a template in this project with Codex CLI and Python 3.9 or newer. The examples use the alias
codexwith adefaulttag. A public template owned by another project cannot be registered in Orpheus. - Prepare a model provider API key. The example uses
gpt-6-sol. - Prepare a Mattermost server with an HTTPS address. The connector needs access to this server to exchange messages. AgentBox sandboxes need access to download attachments and upload files created by the agent. If you need to deploy Mattermost, follow the instructions below.
- Create a bot using the connection guide and save its token.
You will use the Mattermost address and bot token in the next step, when you fill in the Orpheus settings.
If Mattermost is not installed
On a Linux server with Docker, download the official stack:
git clone https://github.com/mattermost/docker.git mattermost-server
cd mattermost-server
cp env.example .env
mkdir -p volumes/app/mattermost/{config,data,logs,plugins,client/plugins,bleve-indexes}
sudo chown -R 2000:2000 volumes/app/mattermostSet DOMAIN, the PostgreSQL password and a pinned MATTERMOST_IMAGE_TAG in .env. Start the services:
docker compose -f docker-compose.yml -f docker-compose.without-nginx.yml up -dPoint your domain's HTTPS reverse proxy to port 8065 and preserve WebSocket connections. Open the site and create an administrator, team and test channel. Then create the bot using the connection guide. See the Mattermost guide for TLS and network details.
Next: start the services.