> ## Documentation Index
> Fetch the complete documentation index at: https://gateway.consus.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Enterprise rollout

> Roll Consus Launcher out to your organization: choose the settings in the portal, push the installer and the lock files with your device management, and have each person sign in once.

This page is for IT admins. It takes you from an empty portal page to a team whose AI tools run on Consus and cannot be reconfigured.

> [!NOTE]
>
> You need to be an admin of your organization in the [Consus portal](https://portal.consus.io). For sign-in with your company account, your identity provider (Okta, Microsoft Entra ID, Google Workspace, or another SAML/OIDC provider) must be connected to the portal. Without it, each person pastes a key from the portal instead.

## The short version

1. **Choose your settings** on the portal's **Launcher** page and save.
2. **Download one package per operating system** from that page.
3. **Push it** with your device management, together with the launcher installer.
4. **Each person signs in once.**

## Before you start

* **A device management tool** that can push a package, a script, and a profile: Jamf or Kandji on macOS, Intune or Group Policy on Windows.
* **Standard user accounts.** The locks hold because only an administrator can change the files. A person who is an administrator on their own computer can remove them.
* **The AI tools themselves.** The launcher sets tools up; it does not install them. Push Claude Desktop, Claude Code, and the others the way you push any app.
* **Two hosts allowed on your network:** `api.consus.io` for requests and `portal.consus.io` for sign-in. The launcher itself contacts nothing else.

## Step 1: Choose your settings

Open the portal and go to **Launcher**.

| Setting | What it does |
| :- | :- |
| **Tools** | Which tools your team sees in the launcher |
| **Data** | What your team handles: ITAR, CUI, or both. Each tool gets only the models allowed for it |
| **Name in the launcher** | The name shown at the top of the launcher and in Claude Desktop's banner |
| **Web access** | Whether a tool's agent may reach the web from the computer. Off by default. Web search stays off either way |
| **Slack** | Optional. Lets Claude read your Slack, read-only, through a Slack app you register |
| **Where locked tools get the key** | Leave this on **Launcher keychain** when you deploy the launcher |

Open a tool's row to see what its lock enforces and the few settings it lets you choose, such as which MCP servers may run.

Click **Save to Consus**. Signed-in launchers pick up the change the next time they start or come to the front. No push is needed for that part.

## Step 2: Download the package

Still on the **Launcher** page, go to **Push it**. Choose your machines, then click **Download all**, at the right of each operating system's heading.

![The portal's Push it step for macOS, listing the installer and the lock files, with Download all at the top right](https://mintcdn.com/consusindustries/wDSYWCnOOxSluafV/assets/launcher-portal-push.png?fit=max\&auto=format\&n=wDSYWCnOOxSluafV\&q=85\&s=ae9fee88be9bc2f191a396542a7cccb5)

The Push it step. Download all is at the right of each operating system's heading.

Each download is a zip with:

* **The lock files** for the tools you turned on.
* **A README** that lists every file, where it lands, and how to push it.

The launcher installer is not in the zip. The README links to it, and it is listed on the same page.

## Step 3: Push it

Push the installer and the lock files together.

> [tab] macOS
>
> | File | What it is | How to push it |
> | :- | :- | :- |
> | `Consus-Launcher-<version>-universal.pkg` | The launcher | As a package |
> | `consus-claude-desktop.mobileconfig` | Claude Desktop's lock | As a custom profile |
> | `consus-claude-desktop-helper.sh` | Lets Claude Desktop get each person's key | As a script, run as root |
> | `consus-claude-code.sh` | Claude Code's lock | As a script, run as root |
> | `consus-factory.sh` | Factory's lock | As a script, run as root |
> | `consus-codex-lock.sh` | Safety settings for ChatGPT and Codex | As a script, run as root |
>
> You only get the files for the tools you turned on.

> [tab] Windows
>
> | File | What it is | How to push it |
> | :- | :- | :- |
> | `Consus-Launcher-<version>-windows-x64.msi` | The launcher | As a line-of-business app |
> | `consus-claude-desktop.ps1` | Claude Desktop's lock and its key helper | As a platform script, run as system |
> | `consus-claude-code.ps1` | Claude Code's lock and its key helper | As a platform script, run as system |
> | `consus-codex-lock.ps1` | Safety settings for ChatGPT and Codex | As a platform script, run as system |
>
> You only get the files for the tools you turned on. Use the `windows-arm64` installer for ARM PCs.

> [!TIP]
>
> Try it on one computer first. Run the scripts by hand as an administrator, sign in as a standard user, and open each tool.

## Step 4: Each person signs in

1. Open **Consus Launcher**.
2. Click **Sign in with Consus** and approve in the browser, using the company account.
3. Open a tool, from the launcher or the usual way.

![Consus Launcher signed in to Test Company, with Claude Desktop and Claude Code marked Managed by your organization](https://mintcdn.com/consusindustries/wDSYWCnOOxSluafV/assets/launcher-managed.png?fit=max\&auto=format\&n=wDSYWCnOOxSluafV\&q=85\&s=66cad1e270cbf3e44270ab473e3edcf7)

Locked tools show Managed by your organization.

A locked tool shows **Managed by your organization** in the launcher. The portal's **Launcher** page has a ready-made note you can send your team.

Tell your team what they will see the first time:

* **On macOS, a few permission prompts:** keychain access (choose **Always Allow**), and Automation and Accessibility, which let the launcher open and place tool windows.
* **Factory asks for its own sign-in** once, with the person's Factory account.
* **Slack asks each person to click Connect** once in Claude Desktop and Claude Code, if you turned it on.
* **Sign-in lasts 30 days.** After that, the launcher asks the person to sign in again.

### Check one computer

Before the full rollout, confirm on one computer, signed in as a standard user:

1. The launcher shows your organization's name and **Connected**.
2. Each locked tool shows **Managed by your organization**.
3. Each tool answers a message when opened outside the launcher, from Spotlight, the Start menu, or a terminal.
4. Claude Desktop's inference settings cannot be edited.

## What the locks enforce

| Tool | Locked | Notes |
| :- | :- | :- |
| Claude Desktop | Yes | Gateway only, your models only, settings not editable |
| Claude Code | Yes | Gateway only, your models only; refuses a personal Claude sign-in |
| Factory | Yes | macOS only |
| ChatGPT and Codex | Partly | Their safety settings are locked. The launcher points them at Consus, but a person can change that |
| Pi | No | Pi offers no lock |

What your team should expect:

* **Locked settings cannot be changed.** They are enforced by the files you pushed, not by the launcher.
* **The locks cover every account on the computer.** A personal Claude sign-in will not work on a locked computer.
* **Signed out means not running.** A locked tool has no key until the person signs in to the launcher again.

## Without device management

You can skip steps 2 and 3. Install the launcher, have each person sign in, and the launcher applies your saved settings itself.

This is quicker to set up, but it is not enforced. A person can change a tool's settings, and the launcher only puts them back the next time it opens that tool.

## Changing settings later

| What you change | What to do |
| :- | :- |
| Tools, data level, web access, name | Save in the portal. Launchers pick it up on their own |
| Anything a lock carries, such as models or MCP servers | Save in the portal, download the package again, and push it again |
| The launcher version | Push the new installer the way the first one went out. The launcher never updates itself |

## Troubleshooting

**A tool says "No Consus key in the keychain."** The person is signed out. Open Consus Launcher and sign in, then try again.

**A tool says "403 Forbidden" right after signing in again.** The tool was already open and is still using the old key. Quit it fully and reopen it. On Windows, closing the window does not quit the app: right-click its icon in the system tray and choose **Quit**.

**Claude Desktop says "Configuration can't be used."** The profile landed without its key helper, or an older package is still on the computer. Push the current package again, including the helper script on macOS.

**The launcher shows "Set by your IT" next to a setting, and portal changes do not reach it.** The computer has the optional pinned settings file. Remove it and the launcher follows the portal again.

## Removing the locks

> [tab] macOS
>
> * Remove the Claude Desktop profile.
> * Delete `/Library/Application Support/Consus`.
> * Delete `/Library/Application Support/ClaudeCode/managed-settings.json`.
> * Delete `/Library/Application Support/Factory/settings.json`.
> * Delete `/etc/codex/requirements.toml`.

> [tab] Windows
>
> * Delete the registry key `HKLM\SOFTWARE\Policies\Claude`.
> * Delete `C:\Program Files\Consus`.
> * Delete `C:\Program Files\ClaudeCode\managed-settings.json` and `C:\ProgramData\Consus`.
> * Delete `C:\ProgramData\OpenAI\Codex\requirements.toml`.

Each person should then quit and reopen their tools.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.