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

# Set up anny Presence

> Turn on automatic check-in with anny Presence, pair monitors and docks with desks, and roll out the app through your IT.

With anny Presence, your team is checked in automatically at their booked desk as soon as their laptop is connected to the desk's monitor or dock. This article is for admins and IT teams. How the app works for employees is described in [anny Presence](https://docs.anny.co/en/anny-presence.md).

> [card] [For employees: Using anny Presence](https://docs.anny.co/en/anny-presence.md)
>
> Signing in, automatic check-in, notices and what to do when nothing happens.

## When should I use this?

* **You want booked desks to actually be used**: check-in happens without anyone doing anything as soon as someone works at the desk, and unused bookings can expire as usual.
* **You want to allow spontaneous work at free desks**: anny books a free desk when someone plugs in and releases it after they unplug.
* **You want to know which desks are really used**: every check-in is stored on the booking like any other.
* **Not suitable for**: rooms without a fixed monitor or dock, and people without their own laptop. Use the [Check-In Terminal](https://docs.anny.co/en/check-in-setup.md) for those.

## Ready in five steps

**1. Prepare the desks**

Turn on check-in and self check-in on every desk (see **Requirements on the resource**).

**2. Turn on anny Presence**

Turn on the app for your organization and decide how it learns, checks out and books (see **Turning it on and configuring it**).

**3. Roll out the app**

Have your IT install the app on the laptops, ideally with the organization preset (see **Rolling out anny Presence**).

**4. Pair the desks**

Walk from desk to desk with your laptop and pair each monitor or dock in the app (see **Pairing desks**).

**5. Check the assignments**

Check in the **Monitors and docks** list that everything is confirmed, and resolve conflicts.

## Turning it on and configuring it

You'll find the settings in the admin area under **Settings** → **anny Presence**. anny Presence is on by default. You can also set the settings through the anny API, which is why the technical names are listed below.

| Setting and technical name | Default | What it does |
| - | - | - |
| Automatic check-in with anny Presence `desktopApp.enabled` | On | Turns the app on for your organization. |
| Assigning new monitors and docks `desktopApp.anchorLearning` | `confirm` | Decides how an answer in the app becomes a lasting link (see below). |
| Check-out after unplugging `desktopApp.checkOutGraceMinutes` | 15 | Minutes after unplugging until check-out, from 0 to 240. |
| Book free desks automatically `desktopApp.allowInstantBooking` | On | Books a free desk with a known monitor or dock and checks in right away. |
| Use Wi-Fi and network as a fallback `desktopApp.wifiFallback` | On | Allows checking in an existing booking over Wi-Fi or the network. |

**Assigning new monitors and docks** has three values:

| Value | Behavior |
| - | - |
| **The first answer counts** `trust` | The first answer counts immediately. |
| **After three matching answers** `confirm` | The link counts once three different people have named the same desk or an admin confirms it. |
| **Don't ask** `off` | The app doesn't ask. Only admins create links. |

If someone names a different desk for a device that isn't confirmed yet, the link is marked as a conflict and is no longer used until an admin resolves it. In the **Monitors and docks** list under **Settings** → **anny Presence**, you can confirm a link, assign it to another desk or area, or delete it. Confirming also resolves a conflict.

The app doesn't learn Wi-Fi access points or network ranges. They have to be linked to an area or location once, centrally. They can only be created through the anny API for now, so during the private beta we set this up together with you. After that, you can adjust them in the **Monitors and docks** list.

## Requirements on the resource

On every desk that should take part, **Check in and check out bookings** must be on under **Resource** → **Check-In**, and **Allow self check-in** must be on in the **Self Check-In** section. Without them, the app neither checks in there nor books automatically.

You can exclude individual resources from anny Presence under **Resource** → **Check-In** → **Self Check-In** with **Allow check-in with anny Presence**. It's on by default, and the technical name is `selfCheckIn.desktopAppEnabled`.

These existing settings under **Resource** → **Check-In** also apply:

| Setting | Effect on anny Presence |
| - | - |
| **Allowed check-in before start of the booking** | The app can check in from this point on. Before that it shows **Too early**. |
| **Automatic expiry of bookings** | Stays independent of anny Presence. A check-in through the app prevents expiry like any other check-in. |
| **Allow self check-out** | Without it, regular bookings aren't checked out when you unplug. |
| **Minimum duration before check-out** | The app doesn't check out before this time has passed. |
| **Release capacity after checkout** | Releases the remaining time of regular bookings after check-out. |

anny can only book desks automatically if they're confirmed immediately and the booking option allows instant booking. There must also be no other booking on the desk in the next 30 minutes.

## Pairing desks

The fastest way to assign monitors and docks is right in the app: walk from desk to desk with your laptop, plug in and pair the desk with one click. Each pairing counts for everyone right away and is confirmed.

Your anny account needs edit rights for your organization's desks. You then find **Pair desks** in the ⋯ menu. You can only pair, move or unpair a desk you're allowed to edit. If you're an admin but not in a community of your organization, the app opens pairing directly and never checks you in.

**1. Start pairing**

Open anny Presence and choose **Pair desks** in the ⋯ menu. Your own check-in pauses until you click **Done**.

**2. Plug in at the desk**

Connect your laptop to the desk's monitor or dock. After a few seconds the device shows up with its state, for example **Not paired yet**.

**3. Pick the desk and pair**

The next unpaired desk is already selected (**Next**). If it's right, click **Pair with …**. Otherwise search the **List** or pick the desk on the **Map**.

**4. On to the next desk**

Unplug and go to the next desk. Click **Done** when you're finished.

The **Map** shows the floor plans from your anny booking map. At the top you pick the site and floor and switch between **2D** and **3D**. Paired desks are green, unpaired ones orange, the selected one blue. Below it you see the progress, for example "3/8 on this floor".

![Pair desks in anny Presence: monitor DELL U2723QE, not paired yet. Below, the list of desks with Desk 4.13 marked Next and the button Pair with Desk 4.13](https://mintcdn.com/anny-85c98540/-wCmR4C67cosoBiP/images/anny-presence/en-pairing-list.png?fit=max\&auto=format\&n=-wCmR4C67cosoBiP\&q=85\&s=c828c688d0c52625e17758d8effc0d3b)

The next open desk is already selected.

![Floor plan in 2D with floor selection. Paired desks green, unpaired desks orange, Desk 4.13 selected in blue](https://mintcdn.com/anny-85c98540/-wCmR4C67cosoBiP/images/anny-presence/en-pairing-map.png?fit=max\&auto=format\&n=-wCmR4C67cosoBiP\&q=85\&s=fed97c8358c0a55e5e2826982b4bbd95)

On the map: green paired, orange open, blue selected.

![The same floor plan in 3D with walls and desks in green, orange and blue](https://mintcdn.com/anny-85c98540/-wCmR4C67cosoBiP/images/anny-presence/en-pairing-map-3d.png?fit=max\&auto=format\&n=-wCmR4C67cosoBiP\&q=85\&s=d9f5182df8ccc60405fdbcd3707e3a45)

The map is also available in 3D.

![Monitor DELL U2723QE paired with Desk 4.13, 5 of 14 desks paired, the button Paired with Desk 4.13 and Unpair](https://mintcdn.com/anny-85c98540/-wCmR4C67cosoBiP/images/anny-presence/en-pairing-paired.png?fit=max\&auto=format\&n=-wCmR4C67cosoBiP\&q=85\&s=de4e0b5c299257a35353afc5cf824d91)

After pairing you move straight on to the next desk.

A device's state tells you what to do:

| State | What you can do |
| - | - |
| **Paired with …** | All set. If it's the wrong desk, pick the right one and click **Move to …**, or **Unpair**. |
| **Named … by people, not confirmed** | **Confirm …** makes the pairing count. |
| **People named different desks** | Pick the right desk and pair it. |
| **No serial number** | The monitor is identified only by model and port. Pair the dock instead if there is one. |

## Rolling out anny Presence (IT)

Installers are available for macOS (`.dmg`, `.pkg`, macOS 11 or later), Windows (`.msi`, `.exe`, x64 and arm64) and Linux (`.deb`, `.rpm`, AppImage). During the private beta, you can get the installers and MDM templates on request via [support@anny.co](mailto:support@anny.co).

All platforms use the same keys. For each key, the first value in this order applies:

1. MDM policy: locked, the app shows the setting with a lock and **Set by IT policy**
2. Organization settings from anny
3. The person's own setting, only for signals, **Open at login** and **Updates**
4. IT defaults: not locked
5. Built-in default

Invalid values are ignored and the next entry applies.

### Key settings

| Key | Default | Purpose |
| - | - | - |
| `OrganizationId` | empty | Binds the app to an organization (ID or slug). The choice is skipped. |
| `DataRegion` | `anny.co` | `anny.co`, `anny.eu` or a custom domain. Locks the choice in the app. |
| `LoginHint` | empty | Pre-filled email on the sign-in page. |
| `SsoProvider` | empty | Goes straight to the SSO provider and skips the password page. |
| `Mode` | `personal` | With `off`, the app doesn't collect or send anything. |
| `SignalMonitor`, `SignalDock`, `SignalWifi`, `SignalSubnet` | True | Turns individual signals on or off. |
| `ActiveNetworks` | empty | Only collects on these networks, as IPv4 CIDRs (`10.20.0.0/16`) or Wi-Fi names. Empty means everywhere. |
| `AllowAnchorLearning` | True | Asks **Which desk is this?** for unknown devices. |
| `LaunchAtLogin` | True | Starts the app at login. |
| `PreventQuit` | False | Hides **Quit anny Presence**. |
| `UpdateMode` | `auto` | With `managed`, your IT department delivers updates and the built-in updater stays quiet. |
| `UpdateChannel` | `stable` | Channel for the built-in updater. |
| `OrgSalt` | empty | Optional key of your organization, so hashing works before the first sign-in. |

> [!NOTE]
>
> anny decides the time until check-out and automatic booking on the server, based on the organization settings. You can't control them reliably through MDM, so use the settings above under "Turning it on and configuring it".

> [!TIP]
>
> Set `ActiveNetworks` to your office networks if the app shouldn't collect anything at home. Employees then also won't get the desk question at their private monitor.

### macOS

The preference domain is `com.anny.presence`. There's a `.mobileconfig` template and a JSON schema for Jamf Pro. Values in the `Forced` section are locked.

* **Jamf Pro**: **Configuration Profiles** → **Application & Custom Settings** → **External Applications** → **Custom Schema**, domain `com.anny.presence`.
* **Intune**: **Devices** → **macOS** → **Configuration** → **Templates** → **Preference file**, domain `com.anny.presence`, as a plist with the keys above.

> [!WARNING]
>
> Wi-Fi on macOS needs Location permission, which MDM can't grant. The current version of the app doesn't ask for it on its own yet either. So set `SignalWifi` to `false` and rely on the monitor, dock and network.

### Windows

Locked values go under `HKLM\SOFTWARE\Policies\anny\Presence`, IT defaults under `HKLM\SOFTWARE\anny\Presence`. Load the ADMX and ADML templates into Group Policy or import them in Intune under **Devices** → **Configuration** → **Import ADMX**. The category is **anny** → **anny Presence**. You can also set defaults at install time:

```bash theme={null}
msiexec /i anny-presence.msi /qn ORG_ID=123 SIGNAL_WIFI=0
```

On Windows 11 24H2 and later, Wi-Fi needs Location access. In Intune, allow it with the policy **Privacy** → **Let apps access location**.

### Linux

Locked values live in `/etc/anny-presence/policy.json`:

```json theme={null}
{
  "OrganizationId": "123",
  "SsoProvider": "azure",
  "SignalWifi": false,
  "ActiveNetworks": ["10.20.0.0/16"],
  "UpdateMode": "managed",
  "PreventQuit": true
}
```

## FAQ

> [accordion] Do I have to pair every desk myself?
>
> No. With **Assign new monitors and docks**, anny also learns desks from your team's answers. Pairing in the app is just the fastest way to cover a whole floor at once.

> [accordion] Can I exclude single desks?
>
> Yes, under **Resource** → **Check-In** → **Self Check-In** with **Allow check-in with anny Presence**. The app then tells people there to check in in anny or with the QR code.

> [accordion] Can I see who sits where?
>
> You see check-ins on the bookings, like any other check-in. The app doesn't send a location, serial numbers or Wi-Fi names.

> [accordion] Who sees who booked a desk?
>
> If someone plugs in at a desk that's taken, the app shows the booker's name only if your organization's booking preview shows names. Otherwise it says "Someone else".

> * Related articles: /en/anny-presence (for employees), /en/check-in-overview, /en/check-in-setup


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