CortexOne Engine: CortexUEE + IA

CortexOne Self-Hosted Installer

Overview

Installing the CortexUEE (Unified Execution Engine) and the Inventory Agent on your server.

Requirements

Requirement	Minimum
Operating System	Ubuntu 22.04+
CPU	2 cores
RAM	4 GB
Disk	40 GB free
Network	Outbound HTTPS access

Opening Port 50051

Google Cloud Platform

Navigate to VPC Network → Firewall → Create Firewall Rule → allow TCP 50051 inbound.

Amazon Web Services

Navigate to EC2 → Security Groups → Edit Inbound Rules → add TCP port 50051.

Microsoft Azure

Navigate to Networking → Add Inbound Port Rule → TCP 50051.

Ubuntu (UFW)

sudo ufw allow 50051/tcp
sudo ufw reload

Installation Command

Run the following command on your server as root or with sudo:

curl -fsSL https://download.cortexone.rival.io/uee-install.sh -o /tmp/uee-install.sh && sudo bash /tmp/uee-install.sh

When the menu appears, select 1) Install CortexUEE + Inventory Agent

Installation Flow

Step	What Happens	Action Required
1	Installation guide prompt	Press Enter to continue
2	Server metadata collection	Enter company name, city, state, postal code
3	Cloud Provider	Enter the desired cloud
4	Public IP detection	None - detected and saved automatically
5	Proceed confirmation	Press Y to confirm
6	Installation summary displayed	Review and note the Node ID

Server Metadata

The installer will ask for the following information to identify your server on the CortexOne dashboard:

Field	Description	Required
Company name	Name of your organization	Yes
City	City where the server is physically located	Yes
State / Province	State or province	Yes
Postal code	Postal / ZIP code	Yes
Public IP	Auto-detected and saved to `/etc/cortexone/server-metadata.conf`	Automatic

What Gets Installed

Component	Details
CortexUEE binary	Installed at `/opt/cortexUEE`
Inventory Agent binary	Installed at `/opt/cortexUEE/cortexIA`
Engine config	`/opt/cortexUEE/configs/engine.yaml`
Inventory Agent config	`/opt/cortexUEE/cortexIA/config.json`
systemd service - engine	`cortex-engine`
systemd service - agent	`cortexIA`
Installation log	`/var/log/cortexone-install.log`
Server metadata	`/etc/cortexone/server-metadata.conf`

Configuration Reference

The Inventory Agent config is written automatically at /opt/cortexUEE/cortexIA/config.json.

No manual configuration is required.

Post-Installation

Once installation completes, verify the services are running:

systemctl status cortex-engine
systemctl status cortexIA

View the Inventory Agent configuration:

sudo cat /opt/cortexUEE/cortexIA/config.json

Day-to-Day Commands

Action	Command
Check engine status	`systemctl status cortex-engine`
Check agent status	`systemctl status cortexIA`
View engine logs	`journalctl -u cortex-engine -f`
View agent logs	`journalctl -u cortexIA -f`
Stop engine	`systemctl stop cortex-engine`
Restart engine	`systemctl restart cortex-engine`
Stop agent	`systemctl stop cortexIA`
Restart agent	`systemctl restart cortexIA`
View config	`cat /opt/cortexUEE/cortexIA/config.json`
View install log	`cat /var/log/cortexone-install.log`

Cleanup

To completely remove installation from your server, run the installer and select the cleanup option.

Run the Installer

curl -fsSL https://download.cortexone.rival.io/uee-install.sh -o /tmp/uee-install.sh && sudo bash /tmp/uee-install.sh

Select `2) Cleanup`

The following will be removed:

Item	Path
systemd service	`cortex-engine`, `cortexIA`
Unit files	`/etc/systemd/system/cortex-engine.service`, `/etc/systemd/system/cortexIA.service`
Install directory	`/opt/cortexUEE`
cortex-pool containers	All containers matching `cortex-pool*`
Docker images	`cortex-python:latest`, `cortex-python-gpu:latest`
Installation log	`/var/log/cortexone-install.log`

Troubleshooting

For common issues and solutions, refer to the CortexOne support documentation.

Next Steps

Port Forwarding Setup