Skip to main content

Running Iris Fully Local — A Step-by-Step Guide to a Cloud-Free Deployment

If your goal is to run Iris with no video data leaving your local network, this article is for you. Local Mode by itself is not the whole story — the way you sign in, the cameras you choose, and how your collaborators join the Studio all matter.


This guide walks through every surface that can quietly pull data from the cloud and gives you a clear, step-by-step formula for shutting that door.

Written for users of any experience level. Terms are defined the first time they appear, and every setting is shown with the exact place in the Iris user interface (UI) where you'll find it.


Why this article exists

A common misunderstanding sounds like this:

"I switched my Studio to Local Mode, so my video isn't going through the cloud."

That's only partly true. Local Mode controls how one device routes its video. It does not, by itself, prevent other users, other cameras, or a different access path from pulling that same video through the cloud. To run a truly local deployment, you need to lock down every surface where cloud routing can happen — not just flip a single toggle.

This article identifies each of those surfaces, explains what they do in plain language, and gives you a step-by-step formula for closing them all.


Quick definitions (read these first)

A few terms come up repeatedly. If any of these are new, this section is for you.

Term

What it means

Studio

Your workspace in Iris. It holds your cameras, layouts, settings, and collaborators. You can have more than one.

Bridge

The computer (or Iris Enabled camera) that connects your cameras to your Studio. Think of it as the on-ramp between your local equipment and Iris.

Desktop Bridge

A regular computer running the Iris desktop app, acting as the Bridge. This is what we want for fully local operation.

Embedded Bridge

An Iris Enabled camera acting as its own Bridge. Today, embedded Bridges only operate in Cloud Mode — so we will not be using these for a fully local setup.

Iris Enabled camera

A camera with Iris software built directly into its firmware. It links to your Studio over the internet using the Iris Enabled protocol and currently runs Cloud Mode only.

Iris Enabled protocol

The network protocol used by Iris Enabled cameras to phone home to your Studio over the internet. Avoid this protocol if your goal is fully local operation.

Iris desktop app

The native application you install on Windows or macOS. It can act as a Bridge, supports Local Mode, and is required for any local-only workflow.

Iris web app / browser

Iris running at studio.tryiris.ai in a browser. The web app always uses Cloud Mode — it cannot operate in Local Mode.

Local Mode

Iris routes your video over your local network only. No cloud quota is used, latency is lowest, and the desktop app is required.

Cloud Mode

Iris routes your video through Iris's cloud servers. Works from anywhere with internet, but the video transits Iris infrastructure.

Lock to Local Mode

An Admin or Owner setting that forces every user of a Studio to operate in Local Mode. Once locked, Cloud Mode is unavailable to everyone — including remote users and browser users.


Before you start

You'll need:

  • An Iris account signed in

  • Admin or Owner role on the Studio (only Admins and Owners can lock a Studio to Local Mode)

  • The Iris desktop app installed on every machine that will connect to the Studio

  • A local network that all your cameras, your Bridge computer, and all collaborators will share

  • Cameras that are not Iris Enabled — meaning standard PTZ, NDI, RTSP, ONVIF, or USB cameras connected over your local network

  • A few minutes to walk through the verification step at the end

If you currently have Iris Enabled cameras linked to your Studio and need fully local operation, plan to remove or unlink them — see Step 2 below.


The cloud-pull surfaces (what actually sends data to the cloud)

Before the steps, here's the full list of places where data can move through the cloud. If even one of these is active in your Studio, you are not fully local. Each of the steps that follow exists to address one of these surfaces.

Surface

What it is

Why it pulls cloud data

How we handle it

The Iris web app (browser at studio.tryiris.ai)

Iris running in Chrome, Safari, Firefox, or Edge

Browsers cannot do peer-to-peer video over a local network. Any Studio session opened in a browser is, by definition, in Cloud Mode.

Use only the desktop app. Disallow the browser path.

Iris Enabled cameras (using the Iris Enabled protocol)

Cameras with embedded Bridges that connect over the internet

These cameras connect to Iris's cloud directly and only operate in Cloud Mode today.

Don't use Iris Enabled cameras. Use standard cameras connected over your LAN.

The Cloud Mode toggle

The cloud icon in the Studio header

A single click flips the active Bridge to cloud routing.

Confirm Local Mode is active, then lock the Studio.

Remote collaborators (off-network users)

Anyone joining your Studio from outside your local network

They have no path to your Bridge over LAN, so their session is Cloud Mode automatically.

Only invite collaborators who can be on the same local network as the Bridge, using the desktop app.

Browser collaborators on-network

A teammate on the same LAN but using a browser

The browser can't do Local Mode even on the same network. Their session pulls cloud.

Require the desktop app for every collaborator.

Cloud recording

A recording destination set to cloud

Sends recorded video to Iris's cloud storage.

Record locally to disk on the Bridge computer instead.

The shortcut to remember. If a path involves a browser, the internet, or an Iris Enabled camera, it's a cloud surface. Local-only means: desktop app + LAN-connected cameras + everyone on the same network.


The step-by-step formula

Follow these steps in order. After the last step, your Studio is fully local and locked against accidental cloud routing.

Step 1 — Install the Iris desktop app on every machine that will use the Studio

The desktop app is the only client that supports Local Mode. The web app, regardless of what your Studio settings say, always uses Cloud Mode.

On every machine — your Bridge computer, every collaborator's computer, and any monitoring or director station — install the Iris desktop app from dl.tryiris.ai.

No browsers. A single teammate using studio.tryiris.ai in a browser is enough to pull video through the cloud for their session, even if your Studio is otherwise local. The browser path must be off-limits for fully local operation.

Where in the UI to confirm: open the desktop app. The Iris window should be a standalone application, not a browser tab. The application icon appears in your dock or taskbar.


Step 2 — Use only standard cameras (skip the Iris Enabled protocol)

Iris Enabled cameras link to your Studio using the Iris Enabled protocol, which connects over the internet through Iris's cloud. They run as Embedded Bridges and currently operate in Cloud Mode only. There is no way to make them fully local today.

For a cloud-free deployment, use standard cameras connected to your local network through any of these supported paths:

  • PTZ cameras over IP (using VISCA over IP, or HTTP control)

  • NDI cameras on the same LAN

  • RTSP cameras (manually added or discovered)

  • ONVIF-discovered cameras

  • USB or capture-card cameras plugged directly into the Bridge computer

  • HDMI sources via a capture device on the Bridge computer

Each of these connects through a Desktop Bridge — a regular computer running the Iris desktop app — instead of phoning home through the cloud.

Where in the UI to check what you have:

  1. Open your Studio in the desktop app

  2. Open the Bridge panel (left side of the Studio header — the icon labeled Bridge)

  3. Look at each entry. Bridges are labeled by type:

    • Desktop Bridge — good, this is what you want

    • Embedded Bridge — this is an Iris Enabled camera. Remove it for fully local operation.

To unlink an Iris Enabled camera:

  1. In the Source Tray (left edge of the Studio), right-click the camera tile or click its gear icon

  2. Select Unlink

  3. Confirm in the dialog

Once unlinked, that camera will no longer connect to your Studio at all.

Why this matters. If even one Iris Enabled camera is connected, the Mode toggle in your Studio will be locked to Cloud Mode automatically. Local Mode is unavailable as long as any Embedded Bridge is in your Studio.


Step 3 — Get every machine on the same local network as the Bridge

Local Mode requires that the device you're operating on and the Bridge computer share the same local network — same Wi-Fi network, same wired LAN, or same VLAN with discovery permitted.

This is true for every collaborator, not just the operator. If a collaborator is on a different network — even another network in the same building — their session falls back to Cloud Mode.

Where in the UI to confirm:

  1. Open the Bridge panel in the desktop app

  2. Find your Desktop Bridge in the list

  3. Look at the connection status under the Bridge name

Status reading

What it means

Online (local)

This client and the Bridge are on the same local network. Local Mode is active.

Online (cloud)

This client is reaching the Bridge through the cloud. You are not fully local.

Offline

Cannot reach the Bridge by any path.

If you see Online (cloud) when you expected local, the most common causes are:

  • The two machines are on different Wi-Fi networks (guest vs. main, for example)

  • A VPN is forcing traffic off the local network

  • A firewall is blocking local discovery (UDP 5353 and 6363 are commonly required)

  • One machine is wired and the other is wireless on isolated subnets

Resolve the network issue, then re-check the Bridge panel.


Step 4 — Confirm Local Mode is active in your Studio header

With every machine on the same network and the desktop app installed, Iris should auto-switch to Local Mode the moment your Bridge is reachable. But you should verify, not assume.

Where in the UI:

  1. Look at the Studio header at the top of the desktop app window

  2. Find the mode toggle — it sits to the right of the Share button

  3. Check the icon:

Icon

Mode

Cloud icon (a small cloud)

Cloud Mode is active

Cloud icon with a slash through it

Local Mode is active

If you see the cloud icon and want to be in Local Mode, click the toggle. A confirmation dialog appears reading "Enable Local Mode? Local mode uses only your local network to ingest video. Your sources will no longer be streamed from the Cloud."

Click Enable Local Mode.

Wait for the toggle to settle. You'll see a notification: "Local Mode activated on [Bridge Name] — Sources for this bridge will now route over your Local network."

💡 The 30-second safety net. If the switch can't complete within about 30 seconds, Iris reverts to whichever mode you started in. So if Local Mode keeps reverting back to Cloud, that's a signal the LAN connection isn't actually working — go back to Step 3.


Step 5 — Lock the Studio to Local Mode

This is the step that turns a current Local Mode session into a permanent policy. Locking the Studio prevents anyone — including future collaborators, browser users, and remote users — from connecting via Cloud Mode. The Mode toggle becomes disabled for every user of the Studio.

Only Admins and Owners can lock a Studio. Producers and below cannot.

Where in the UI:

  1. Confirm your Studio is currently in Local Mode (cloud-with-slash icon visible in the header)

  2. Look immediately to the left or right of the Mode toggle. As an Admin or Owner, you'll see a small lock icon.

  3. Click the lock icon

  4. A confirmation appears: "Your Studio is now locked in Local Mode. Users are now required to access the Studio in Local Mode."

That's it. The Mode toggle is now grayed out for every user, including you. Cloud Mode is unavailable until an Admin or Owner unlocks the Studio.

What other people experience after you lock:

Who they are

What they see when they try to join

Desktop app user on the same local network as the Bridge

They join normally in Local Mode — no change in their experience

Desktop app user on a different network

A dialog explaining the Studio is locked, listing the names of the Bridges they need to be on the same network as. They cannot join until they're on that network.

Browser user (any network)

A dialog asking them to open the Iris desktop app, with a link to download it if they don't have it. They cannot join the Studio in the browser at all.

This is your guarantee against accidental cloud pull. Without the lock, any user can flip the Mode toggle back to Cloud Mode mid-production. With it locked, no one can — not even by mistake.

To unlock later (if your needs change):

  1. As an Admin or Owner, click the lock icon again next to the Mode toggle

  2. Confirmation: "Your Studio is unlocked from Local Mode. Users can now use the Studio in Local or Cloud mode."


Step 6 — Set recording to local disk only

If you record sessions, confirm that recordings are saving to a folder on the Bridge computer's local disk, not to a cloud destination. Local recording is the default, but it's worth checking.

Where in the UI:

  1. Open the Recording panel from the Studio header (look for the record icon)

  2. Open Recording Settings

  3. Confirm the destination is set to a path on the Bridge computer (e.g., C:\\\\Iris\\\\Recordings on Windows or ~/Iris/Recordings on macOS), not a cloud destination

Recordings written to local disk never traverse the cloud. They are produced by the Bridge computer and saved on the Bridge computer.


Verification — how to confirm your Studio is truly local

After completing all six steps, run through this quick checklist. If every line passes, you're fully local.

Check

Where to look

What "passing" looks like

1. Studio is in Local Mode

Studio header

Cloud-with-slash icon visible

2. Studio is locked

Next to Mode toggle

Lock icon shows the locked state; toggle is grayed out

3. All Bridges are Desktop Bridges

Bridge panel

Every entry labeled Desktop Bridge; no Embedded Bridge entries

4. Every active client is on the same network

Bridge panel for each user

Every user's row reads Online (local)

5. No one is in the browser

Active users list

Avatars show only desktop app users; nobody listed as browser

6. Recording destination is local

Recording Settings

Destination path is a local folder on the Bridge computer

If any line fails, return to the corresponding step.


Common mistakes

A few patterns we see often, with the fix:

"I locked the Studio to Local Mode, but my colleague says they can still use the browser." They cannot — but they may be confused by what they see. After the lock, the browser shows a dialog directing them to the desktop app. Their attempt still happens in the browser, but no Studio session opens. Confirm with them by checking the active users list in your Studio: if they're not listed, they didn't actually get in.

"I unlinked an Iris Enabled camera, but the Mode toggle is still locked to Cloud." There may be more than one Embedded Bridge connected. Open the Bridge panel and confirm every entry is labeled Desktop Bridge. Unlink any remaining Embedded Bridges.

"My session keeps falling back to Cloud Mode every few minutes." This usually means an unstable LAN connection between your machine and the Bridge. Iris falls back to Cloud Mode automatically when it loses sight of the Bridge over LAN. Check Wi-Fi signal strength, or move to a wired connection. The fallback exists for a reason — it keeps your Studio working — but it does mean you'll briefly route through cloud during the dropout. If the lock-to-local setting is on, the fallback to Cloud Mode is suppressed and the session will simply disconnect until LAN is restored.

"I disabled cloud quota in my plan settings — does that prevent cloud routing?" No. Plan-level quota is about billing, not routing. Disabling quota does not block Cloud Mode; it only changes what you're charged for. The only way to actually prevent cloud routing is the steps in this article.

"We're using a VPN to keep things private — do we still need Local Mode?" A VPN encrypts traffic but doesn't change which servers it goes through. If your VPN routes you off your LAN, Iris will still classify your session as Cloud Mode. Use Local Mode in addition to (not instead of) any other network controls.


Frequently asked questions

Will Iris pick Local Mode automatically if I follow these steps?

Yes — when the desktop app detects a Bridge on the same local network, it auto-switches to Local Mode without you doing anything. The lock step is what makes it stick across all users and sessions.

Do I lose any features by going fully local?

Auto-Tracking, Magic Movement Tools, Position Presets, recording, multi-user collaboration, and full camera control all work in Local Mode. The features that don't work in Local Mode are remote-access features by definition — the ability to operate from outside the venue, and the use of Iris Enabled cameras.

Can I temporarily unlock for a single remote session and re-lock afterward?

Yes. An Admin or Owner can unlock at any time, run the remote session in Cloud Mode, and re-lock when finished. Be aware that during the unlocked window, video routing is no longer guaranteed to stay local.

Does locking apply per-Studio or to my whole Iris account?

Per-Studio. Each Studio has its own lock state. If you have multiple Studios and want them all fully local, lock each one individually.

What happens to my locked Studio if my internet goes out completely?

Local Mode does not require the internet to keep working — your video continues routing over your LAN regardless. You will, however, lose the ability to authenticate new users into the Studio while the internet is down, since sign-in goes through Iris's account servers. Existing signed-in sessions continue.

My recordings — are they ever uploaded anywhere?

Recordings written to a local disk destination on the Bridge computer stay on that disk. They are not uploaded automatically. If you later choose to upload them, that's a separate, manual action.

Can the Iris service see my video at all in this setup?

In a fully local deployment, your video frames travel only between your cameras, your Bridge, and your client machines, all on your LAN. They do not transit Iris's servers. Account metadata (who is signed in, Studio configuration, license state) does still synchronize with Iris's servers when you have internet — that's how user permissions and licensing stay current. The video itself is local.

Are Iris Enabled cameras always cloud-only?

For now, yes. Local Mode support for Embedded Bridges is on the product roadmap but not shipping today. If your environment requires fully local operation, plan around standard cameras instead.

Can I mix some Iris Enabled cameras with a locked Local Mode Studio?

No. The presence of any Iris Enabled camera in a Studio forces the Mode toggle to Cloud Mode. The two are mutually exclusive today.

Did this answer your question?