# Introduction

Hamina Onsite is an iOS/iPadOS/macOS app for performing Wi-Fi site surveys. Hamina Onsite typically connects to external survey hardware, and is accessed with a Hamina Onsite subscription.

## Getting Started

{% stepper %}
{% step %}

### Activate Hamina Onsite

Once you've purchased a Hamina Onsite subscription, [log into Hamina Network Planner](https://app.hamina.com/) to [activate the Hamina Onsite subscription to your account](#activating-hamina-onsite).
{% endstep %}

{% step %}

### Get the App

Get Hamina Onsite from the [App Store](https://apps.apple.com/us/app/hamina-onsite/id1662085386) or [Mac App Store](https://apps.apple.com/us/app/hamina-onsite/id1662085386). It runs on iPhone, iPad, and Apple Silicon MacBooks.
{% endstep %}

{% step %}

### Set up Survey Hardware

Set up and connect your [Hamina Clip](https://docs.hamina.com/hamina/onsite/hardware/clip), [Oscium Nomad](https://docs.hamina.com/hamina/onsite/hardware/oscium-nomad), or [WLAN Pi](https://docs.hamina.com/hamina/onsite/hardware/wlan-pi) to your iPhone, iPad, or Apple Silicon MacBook.
{% endstep %}

{% step %}

### Perform a Site Survey

All of your projects from Hamina Network Planner will syncronize and appear in Hamina Onsite. Once you've completed a survey, it will automatically syncronize with Hamina Network Planner. We do recommend [reading up on how to perform site surveys with Hamina](https://docs.hamina.com/hamina/onsite/site-surveys).
{% endstep %}

{% step %}

### Perform In-depth Analysis and Create Reports

You can do some lightweight analysis directly in Hamina Onsite, but for in-depth analysis and report generation, [open the project in Hamina Network Planner](https://app.hamina.com/).
{% endstep %}
{% endstepper %}

## Activating Hamina Onsite

1. Sign into the [Hamina Planner web app](https://app.hamina.com/).

2. Click the **Account** menu, and select **Subscriptions**.<br>

   <div align="left"><figure><img src="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2F7oR8lW8o5KlEEceqU2ay%2Fsubscriptions.png?alt=media&#x26;token=db1e4503-3ee1-4c4d-a320-6f7a455ddad6" alt="" width="331"><figcaption></figcaption></figure></div>

3. In the **Subscriptions** area, you will see a line item for Onsite. To the right, click the **...** menu, and click **Activate.** *<mark style="color:blue;background-color:blue;">Note: You can also copy the license key to share with someone else.</mark>*

4. You Hamina Onsite license should now be activated.

### Get the Hamina Onsite App <a href="#get-the-hamina-onsite-app" id="get-the-hamina-onsite-app"></a>

Get Hamina Onsite from the [App Store](https://apps.apple.com/us/app/hamina-onsite/id1662085386) or [Mac App Store](https://apps.apple.com/us/app/hamina-onsite/id1662085386).

| iPhone  | iOS 17 or newer    |                             |
| ------- | ------------------ | --------------------------- |
| iPad    | iPadOS 17 or newer |                             |
| MacBook | macOS 14 or newer  | Apple Silicon MacBooks only |

### Set up Survey Hardware <a href="#set-up-survey-hardware" id="set-up-survey-hardware"></a>

On iPhone and iPad, Hamina Onsite needs to connect to an external measurement device such as a Hamina Clip, Oscium Nomad, or WLAN Pi.

{% hint style="info" %}
The Hamina Clip is not shipping yet, but [a waitlist is available](https://www.hamina.com/clip).
{% endhint %}

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><a href="hardware/clip">Learn how to use the Hamina Clip</a> with Hamina Onsite.</td><td><a href="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2F62dZcHkU6HvaS8lzoCb0%2Fhamina-clip.png?alt=media&#x26;token=00d7136e-8891-4db2-a436-421fd9cb4850">hamina-clip.png</a></td></tr><tr><td><a href="hardware/oscium-nomad">Learn how to use the Oscium Nomad</a> with Hamina Onsite</td><td data-object-fit="contain"><a href="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2FnPrJTKlbXgvkF1COnFVj%2Foscium-nomad.png?alt=media&#x26;token=f4ad1138-5d1e-4257-a606-5c26df799e1a">oscium-nomad.png</a></td></tr><tr><td><a href="hardware/wlan-pi">Learn how to set up and use the WLAN Pi</a> with Hamina Onsite.</td><td data-object-fit="contain"><a href="https://1547340717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzUQ3TfKTYBeb6nf9W8Hv%2Fuploads%2Fpa1mtMpjCM1EQ3l68zrM%2Fwlan-pi.png?alt=media&#x26;token=e8cef1a4-11a7-4a0c-a32c-719b79ec8074">wlan-pi.png</a></td></tr></tbody></table>

### Perform Site Surveys <a href="#perform-site-surveys" id="perform-site-surveys"></a>

To learn how to perform site surveys with Hamina Onsite, see [site-surveys](https://docs.hamina.com/hamina/onsite/site-surveys "mention").