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

# First-Run Setup

> Walk through the desktop app's setup steps for an instrument workstation

The first time Atomscale opens, an onboarding wizard walks you through connecting the computer. The steps below are in the order they appear. You can leave at any point with Exit setup and return later from **Settings > Onboarding**.

| Step | Required | Shown |
| - | - | - |
| [1. Connection](#1-connection) | Yes | Always |
| [2. Purpose](#2-purpose) | Yes | Always |
| [3. Sign in](#3-sign-in) | Yes | Always |
| [4. Integrations](#4-integrations) | No | Always |
| [5. Admin access](#5-admin-access) | No | On Windows |
| [6. Sharing](#6-sharing) | No | When the computer connects to Atomscale directly |

## 1. Connection

Setup first checks how this computer reaches Atomscale.

* **"Connection ready"**: Atomscale is reachable directly or through the computer's system proxy. Click Continue.
* **"We were not able to connect to the Atomscale platform"**: Click Retry connection after fixing the network, or use another lab computer's connection.

If the instrument computer has no internet access, another computer on the same network can relay its traffic. Under **Use another lab computer's connection**, enter the **Hostname or IPv4 address** and **Port** shown on that computer, and click Test connection. That computer must already be running Atomscale as a Connection Sharing **Hub**; see [Connection Sharing](https://docs.atomscale.ai/gateway/connection-sharing.md).

This step can't be skipped. Setup needs a working route to Atomscale to continue.

## 2. Purpose

Choose Monitor and analyze growths. This selects **Full** mode, the complete application. Its icon rail on the far left includes **Integrations**, and **Data** includes the **Growth Instruments** page you need to [link integrations](https://docs.atomscale.ai/gateway/data.md#link-integrations-to-the-growth-instrument).

Connect an instrument selects **Data Ingestion** mode, for a computer that only collects data. It has no rail and shows only these pages in its sidebar:

| Sidebar item | Use |
| - | - |
| **Data Catalog** and **Recipes** | Browse uploaded data and recipes. |
| **Integrations** | Add, configure, and monitor integrations. In this mode, this is where the app opens. |
| **Documentation** | This guide, built into the app so it works offline. |
| **Settings** | Desktop app settings. See [Settings Reference](https://docs.atomscale.ai/gateway/reference/settings.md). |

Data Ingestion mode has no Growth Instruments page, so create them in the web app. You can switch modes later under **Settings > Application**.

## 3. Sign In

Sign in with an account in the organization that should own this gateway. Social and SSO sign-in open in your web browser, then return to the app.

A gateway belongs to the **first organization that signs in on it**. After that:

* Anyone from the same organization can sign in and operate it.
* An account from a different organization can sign in, but uploads pause with "Gateway access denied. Switch to an account in this Gateway's owning organization to resume uploads." Integrations keep collecting locally until an account from the owning organization signs in.

To move a gateway to a different organization, contact Atomscale support.

## 4. Integrations

Add the integrations this computer will run:

| Integration | Add it if |
| - | - |
| **RHEED Camera (GenTL)** | A RHEED camera is connected to this computer. See [RHEED Camera](https://docs.atomscale.ai/gateway/rheed.md). |
| **kSA 400** | kSA 400 runs your RHEED camera, and you want the frames its Image Streamer sends, after kSA 400's filters. Choose this or RHEED Camera (GenTL), not both. See [kSA 400](https://docs.atomscale.ai/gateway/rheed/ksa-400.md). |
| **Tool Log Streamer** | This computer can read the folder where your tool's control software writes its logs. See [Tool Logs](https://docs.atomscale.ai/gateway/tool-state.md). |
| **FilmSense FS-1** | A Film Sense ellipsometer is on this computer's network. See [FilmSense FS-1](https://docs.atomscale.ai/gateway/filmsense.md). |
| **File Watcher** | An instrument saves finished files to a folder this computer can read. See [File Watcher](https://docs.atomscale.ai/gateway/file-watcher.md). |

Click Add on each one you need. Adding only downloads the integration; you configure and start it later from **Integrations**. You can skip this step and add integrations later.

## 5. Admin Access

**Windows only.** This step offers **Integration admin access**, which lets integrations that need administrator rights run with them. The RHEED Camera integration needs it for its default **Network (GVSP Tap)** frame source. The step shows Recommended if any integration you added may need it. Enable it on every workstation anyway; [Integration Admin Access](https://docs.atomscale.ai/gateway/admin-access.md) explains why.

Click Enable admin access. Windows asks an administrator to approve once. The prompt names **Windows PowerShell** from Microsoft Windows, because Atomscale uses PowerShell to install its signed component, and it may open behind the Atomscale window. When it shows Enabled, click Continue.

If no administrator is available, click Skip for now and turn it on later from **Settings**. See [Integration Admin Access](https://docs.atomscale.ai/gateway/admin-access.md) for what it installs.

## 6. Sharing

This step appears only when the computer connected to Atomscale directly. Turn the switch on to let lab computers without internet access connect through this one, as a Connection Sharing **Hub**. The step then lists the addresses to enter on those computers. Leave it off if you don't need it.

Click Finish setup. The app opens on **Home** in Full mode; click Integrations in the rail. In Data Ingestion mode it opens on **Integrations**. The integrations you added show Not configured until you enter their settings, or Stopped if they need none. Click each one to configure and start it; see [Working with Integrations](https://docs.atomscale.ai/gateway/integrations.md).

## Next Steps

> [card] [Set up a RHEED camera](https://docs.atomscale.ai/gateway/rheed.md)
>
> Stream frames from the camera your RHEED software is running.

> [card] [Set up tool logs](https://docs.atomscale.ai/gateway/tool-state.md)
>
> Stream the logs your tool's control software writes.


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