Install Agent on Linux

Our open-source server agent securely bridges shells and databases to your LLM provider of choice, with filtering and logging. Supports Ubuntu, Debian and MacOS (more to come!).

Before you install

Create a portal in the Gentility Console so the agent has a network anchor to register against. Each portal generates an access token you'll paste into the installer.

Gentility Console showing the New Portal form — Start at **Portals → New portal** and choose a region that is closest to your infrastructure.

Portal detail page showing status online — After creation the portal status turns **Online** once the agent connects.

Portal configuration panel with the access token visible — Copy the portal access token from this panel — you’ll need it when the installer prompts for `GENTILITY_PORTAL_TOKEN`.

Option 1: APT Repository (Recommended)

# Add GPG key
sudo mkdir -p /etc/apt/keyrings
curl -s https://packages.gentility.ai/gentility-packages.gpg  | sudo tee /etc/apt/keyrings/gentility-packages.asc > /dev/null

# Add repository
echo "deb [signed-by=/etc/apt/keyrings/gentility-packages.asc] https://packages.gentility.ai/debian/ stable main" | sudo tee /etc/apt/sources.list.d/gentility.list

# Install agent
sudo apt update
sudo apt install gentility-agent

Option 2: Direct DEB Package

# Download latest package
wget https://github.com/gentility-ai/agent/releases/download/v1.0.32/gentility-agent_1.0.32_amd64.deb


# Install package
sudo dpkg -i gentility-agent_1.0.32_amd64.deb
sudo apt-get install -f

Setup & Configuration

# Initial setup (requires access token)
sudo gentility setup YOUR_TOKEN_HERE

# Start the agent
gentility run

Source Code

https://github.com/gentility-ai/agent

View on GitHub

Installation walkthrough placeholder

Prerequisites

Linux AMD64 (x86_64) system
Ubuntu 20.04+, Debian 11+, or CentOS 8+
sudo, curl installed
ChatGPT Plus or Claude Pro (for MCP client features)

Why Gentility?

Command filtering and audit logs
Write-block modes for databases
Works with Claude; ChatGPT support is experimental