> For the complete documentation index, see [llms.txt](https://swift.objectbox.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://swift.objectbox.io/advanced/macos.md).

# The Sandbox on macOS

### The Sandbox on macOS

{% hint style="info" %}
You do *not* need to perform any of these steps for an application running on *iOS*, or if your macOS application is *not sandboxed*.
{% endhint %}

Currently, use of ObjectBox from a sandboxed *macOS* application requires you to set up at least one *App Group* for ObjectBox to be able to open a database, in addition to whatever you would normally have done to gain access to the destination folder under the sandbox:

1. Open your project in Xcode.
2. Select the project icon at the very top of the *Project Navigator*.
3. Select the *Signing & Capabilities* tab where you turned on *App Sandbox*.
4. Click the *+ Capability* button and double-click *App Groups*.
5. If the *App Groups* list is empty, click the little "+" icon to add one.

You should now see a list entry like `FGDTDLOBXDJ.$(TeamIdentifierPrefix)`. If you only see `$(TeamIdentifierPrefix)` , you still need to set up your team and code-signing under *General*.

That should be it: ObjectBox will pick up the *App Group Identifier* without any additional work.

{% hint style="info" %}
Pick a short group identifier. There's an internal limit in macOS of 31 characters for semaphores, that enforces the complete string (`FGDTDLOBXDJ.$(TeamIdentifierPrefix)` in the example) to be 20 characters or less.
{% endhint %}