Install Ultra

For enterprise fleet deployment via Jamf Pro, see the MDM Deployment Guide. It covers zero-touch installation, deploy key authentication, and per-user identity resolution via SCIM.

Download from Website
CLI

Download Ultra

Visit ultra.security and download the installer for your platform.

macOS

Download the signed and notarized .pkg installer and double-click to install.You can also download the .pkg directly:

https://get.ultra.security/v{VERSION}/Ultra-{VERSION}-macOS.pkg

Linux & Windows

Download the binary for your platform from the website and place it in your PATH.

Verify Installation

After installing, open your AI agent and ask it to verify:

“Check your connection to Ultra”
“Run ultra doctor”

Your agent should confirm that Ultra is installed and running.

Install via Terminal

Run the install script:

curl -sSL https://get.ultra.security/install.sh | sh

The install script:

Auto-detects your OS (macOS, Linux, Windows) and architecture (amd64, arm64)
Downloads from CDN (get.ultra.security) with GitHub Releases fallback
Installs to /usr/local/bin (or uses sudo if needed)
Removes macOS quarantine attributes automatically

Environment Variables

Customize the installation with environment variables:

Variable	Default	Description
`INSTALL_DIR`	`/usr/local/bin`	Custom installation directory
`VERSION`	Latest release	Pin to a specific version
`ULTRA_DEPLOY_KEY`	None	Deploy key to enroll with, saved during install
`ULTRA_DEVICE_EMAIL`	None	Your work email, used to attribute this device to you

Set them on the sh that runs the script, not on curl, or the script never sees them:

# Install to a custom directory
curl -sSL https://get.ultra.security/install.sh | INSTALL_DIR=~/.local/bin sh

# Install a specific version
curl -sSL https://get.ultra.security/install.sh | VERSION=0.5.0 sh

Verify Installation

After installing, verify Ultra is working:

ultra version

Run diagnostics to check your system:

ultra doctor

Upgrading

Re-run the install script to upgrade to the latest version:

curl -sSL https://get.ultra.security/install.sh | sh

Installing with a Deploy Key

If your admin gave you a deploy key, hand it to the installer and your device links itself. No sign-in, and no ultra login or ultra link.

Download from Website
Terminal

The macOS and Windows installers both ask for the key during setup: macOS on a step titled Ultra Enrollment, Windows on the first step of Ultra Setup.

Paste the key into Setup code. Your admin may call it a deploy key; it is the same value and starts with dk_
Enter your Work email. This is what attributes the device to you in Ultra
Click Continue

Choose Skip if you were not given a key. You can sign in through the browser instead the first time Ultra starts.

Pass the key to the install script and it saves it for you. Set the variables on sh, not on curl:

curl -sSL https://get.ultra.security/install.sh | \
  ULTRA_DEPLOY_KEY=dk_your_key_here \
  ULTRA_DEVICE_EMAIL=you@example.com \
  sh

Your device links to the key’s workspace the first time Ultra starts. Already installed Ultra? Set the key afterwards and restart your AI agent, and Ultra picks it up on the next start. This reads the key from standard input, so it never lands in your shell history:

ultra config set deploy-key

See Deploy Keys for the config file and managed preference options, plus the full reference.

Platform Support

Platform	Architecture	Status
macOS	Intel (amd64)	Supported
macOS	Apple Silicon (arm64)	Supported
Linux	amd64	Supported
Linux	arm64	Supported
Windows	amd64	Supported

After installing or upgrading Ultra, restart your MCP agent (e.g., quit and reopen Claude Desktop, Cursor, etc.) for changes to take effect.

Ultra is distributed from a private repository. go install is not available. Use the website download or install script.

Next Steps

Configure Agents

Set up your MCP agents to use Ultra

Getting Started

Ultra Hub

Observability

Concepts

Install Ultra

Download Ultra

macOS

Linux & Windows

Verify Installation

Install via Terminal

Environment Variables

Verify Installation

Upgrading

Installing with a Deploy Key

Platform Support

Next Steps

Configure Agents

​Download Ultra

​macOS

​Linux & Windows

​Verify Installation

​Install via Terminal

​Environment Variables

​Verify Installation

​Upgrading

​Installing with a Deploy Key

​Platform Support

​Next Steps

Configure Agents

Download Ultra

macOS

Linux & Windows

Verify Installation

Install via Terminal

Environment Variables

Verify Installation

Upgrading

Installing with a Deploy Key

Platform Support

Next Steps