# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://swift.objectbox.io/advanced/macos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.