Your connection plan

Your first connection.
One clear next step.

Choose your starting point. Follow the steps on your devices, then mark each one done here.

WHERE ARE YOU STARTING?

Changing your starting point resets this checklist.

YOUR CHECKLIST0 / 4
SETUP / 01ON YOUR INFRASTRUCTURE

ON YOUR IPHONE OR IPAD

Put Fleet on your phone.

You’ll need iOS 26 or later. Install Apple TestFlight from the App Store, then open the Fleet invitation and install the beta.

Open TestFlight invitation ↗

This is your checklist, not a connection test. Progress lasts while this page stays open. Help pages open in a new tab. No addresses or credentials are collected.

Prefer the complete guide? All instructions are below. ↓
01

Before you start

You need an iPhone (or iPad) running iOS 26 or later, and a Hermes Agent gateway you control that your device can reach over the network. Fleet ships with no maintainer endpoint and no shared credentials.

Still deciding where the gateway should run? Read hosting a Hermes gateway for home hardware, VPS, and managed-service tradeoffs. Fleet is a bring-your-own-gateway client; no particular hosting provider is required.

  • iOS 26 or later
  • A Hermes gateway you control
  • The gateway address and a credential, if it uses one
02

Install the beta

Hermes Fleet is distributed through Apple TestFlight. Install TestFlight from the App Store, then open the invitation on your device.

Open the TestFlight invitation

This is a beta. Expect rough edges, and see known issues.

03

Add your gateway

Open Add Gateway and give it a display name, the endpoint, the authentication strategy, and the credential. Prefer HTTPS on any network you do not fully trust. For Connector 0.3.0 pairing, ask Hermes for a link with /fleet pair in a private chat or run hermes fleet pairon the Hermes computer. Open or scan the link in Fleet, compare the six-digit code, and have the owner approve that exact code.

Which credential does each authentication strategy need?

Already run Hermes on a machine? Copy the built-in setup prompt (first-run screen, or Settings ▸ Set Up Another Server) and send it to your Hermes agent. It checks for the Fleet Connector and explains what is missing. It asks before installation or service changes and does not guess a source URL or command. Pairing is available after the connector is installed and configured.

Read the pinned Connector 0.3.0 installation guide before installing gateway software.

04

Confirm a healthy connection

After saving, the gateway should reach a healthy connected state, visible per gateway in the app. Classified failures surface in Fleet ▸ Needs You.

Fleet shows what this phone has observed. There is no fleet-wide telemetry, and sections that would otherwise look empty say “N known items” instead.

Troubleshooting

05

Have your first conversation

Tap Chat in the drawer, pick a bot or session, and send a harmless prompt. The reply streams in together with any tool activity.

06

Where things live

The drawer holds Bots, Chats, Groups, Scheduled, Kanban, Fleet, and Artifacts, with Settings and About alongside. Command Center is a global search-and-jump sheet. For running work across machines, turn on Live Ops.

07

Lock it down

Turn on App Lock in Settings. Approvals already ask for Face ID or your passcode. Read how Fleet handles your data in the security overview and privacy policy.