<!--
{
  "availability" : [
    "iOS: 14.0.0 -",
    "iPadOS: 14.0.0 -",
    "macCatalyst: 14.0.0 -",
    "watchOS: 7.3.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "NearbyInteraction",
  "identifier" : "/documentation/NearbyInteraction/NISession/run(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Nearby Interaction"
    ],
    "preciseIdentifier" : "c:objc(cs)NISession(im)runWithConfiguration:"
  },
  "title" : "run(_:)"
}
-->

# run(_:)

Starts a session with a nearby peer.

```
func run(_ configuration: NIConfiguration)
```

## Parameters

`configuration`

An object that indicates an interaction session’s features.

## Discussion

This function starts an interaction session between two devices.

Before calling this function, ensure the device supports the features your app requires by first inspecting global [`deviceCapabilities`](/documentation/NearbyInteraction/NISession/deviceCapabilities).

### Restart an Interaction Session

To restart a session as the result of unpausing, call this function as described in [`pause()`](/documentation/NearbyInteraction/NISession/pause()). The app calls this function when resuming from session suspension, as described in [`sessionSuspensionEnded(_:)`](/documentation/NearbyInteraction/NISessionDelegate/sessionSuspensionEnded(_:)).

> Note:
> A session’s ``doc://com.apple.nearbyinteraction/documentation/NearbyInteraction/NISession/discoveryToken`` maintains its original value through restarts.

### Prompt for User Approval

The framework prompts for user permission to provide its relative position to nearby peers when it calls this function the first time the app launches. On subsequent calls to this function, the framework consults a preference in Settings that stores the user’s decision. For more information, see [Initiating and maintaining a session](/documentation/NearbyInteraction/initiating-and-maintaining-a-session).

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)