> ## 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.

# Set Up Atomscale

> Install the Atomscale desktop app on your lab computer and stream your instruments' data to Atomscale

A **gateway** is a Windows computer that runs the Atomscale desktop app and can reach your instruments' data. Its **integrations** collect that data and upload it to Atomscale. Follow these steps to set one up.

Setup takes about 10 minutes. You need your Atomscale account, and a Windows administrator for one prompt.

## Before You Begin

* **An Atomscale account** in the organization that will own the workstation. If you don't have one, ask an Admin in your organization to [invite you](https://docs.atomscale.ai/platform/reference/account-management.md#inviting-members).
* **The installer**, from [Atomscale support](mailto:support@atomscale.ai).
* **A Windows 10 or later computer** with internet access and access to the instruments' data.
* **A Windows administrator** to approve one prompt.

> [accordion] Windows 7 or XP, no internet access, no administrator, or IT review?
>
> | Situation | What to do |
> | - | - |
> | The workstation runs Windows 7 or XP | Install the Atomscale CLI instead. See [Windows 7 and XP](https://docs.atomscale.ai/gateway/installation.md#windows-7-and-xp). |
> | The workstation has no internet access | Set up another lab computer on the same network as a Connection Sharing **Hub**, and enter its address at setup's **Connection** step. See [Connection Sharing](https://docs.atomscale.ai/gateway/connection-sharing.md). |
> | No administrator is available | At **Admin access**, click Skip for now, and turn it on later from **Settings**. Until then, RHEED network capture can't start. See [Integration Admin Access](https://docs.atomscale.ai/gateway/admin-access.md). |
> | IT needs to review the setup first | Share [Network Requirements](https://docs.atomscale.ai/gateway/reference/network.md), [Integration Admin Access](https://docs.atomscale.ai/gateway/admin-access.md), and [Files and Logs](https://docs.atomscale.ai/gateway/reference/files-and-logs.md). |
>
> For anything else, see [Troubleshooting](https://docs.atomscale.ai/gateway/reference/troubleshooting.md).

## Steps

**1. Install the desktop app**

Choose the Windows user account that will run Atomscale, and sign in to Windows as that user.
The gateway runs only while that user is signed in. Run the installer with its defaults, then
open **Atomscale**.

**2. Complete first-run setup**

Atomscale opens an onboarding wizard. Go through its screens:

1. **Connection**: click Continue.
2. **Purpose**: choose Monitor and analyze growths.
3. **Sign in** with your Atomscale account.
4. **Integrations**: click Add on the integration for each of your data sources:
   * RHEED camera: **RHEED Camera (GenTL)**, or **kSA 400** if kSA 400 runs your camera. Add one, not both.
   * Tool logs: **Tool Log Streamer**.
   * Ellipsometer: **FilmSense FS-1**.
   * Files an instrument saves to a folder: **File Watcher**.
5. **Admin access**: click Enable admin access, and have the administrator approve the Windows prompt. It names **Windows PowerShell**, publisher Microsoft Windows, and may open behind the Atomscale window.
6. **Sharing**: leave it off, and click Finish setup.

> [accordion] More about first-run setup
>
> * The admin access prompt names Windows PowerShell because Atomscale uses PowerShell to install its signed component.
> * Enable admin access even without a RHEED camera, so integrations you add later need no administrator. See [Integration Admin Access](https://docs.atomscale.ai/gateway/admin-access.md).
> * **Monitor and analyze growths** is the full app, which you need to create Growth Instruments in step 4. **Connect an instrument** shows only data collection pages; choose it later under **Settings > Application** if no one analyzes data on this computer.
> * Turn **Sharing** on only if other lab computers without internet access will upload through this one. See [Connection Sharing](https://docs.atomscale.ai/gateway/connection-sharing.md).
>
> See [First-Run Setup](https://docs.atomscale.ai/gateway/first-run.md) for every screen.

**3. Configure your integrations**

After you click Finish setup, the app opens on **Home**. Click Integrations
in the icon rail on the far left. It lists the integrations you added. Those that need settings show Not configured.

To have the app configure an integration for you, click **Ask assistant**. Tell the [Gateway assistant](https://docs.atomscale.ai/gateway/assistant.md#set-up-an-integration) which integration to configure and where to find the data. Ask it to leave the integration stopped until you link it to a Growth Instrument.

To configure an integration yourself, select it and click Configure. Enter its settings and click Apply Configuration. Don't start it yet. Find your data source:

> [tab] RHEED
>
> **RHEED Camera (GenTL)** needs no settings: it finds the camera when you start it. See
> [RHEED Camera](https://docs.atomscale.ai/gateway/rheed/network-capture.md).

> [tab] kSA 400
>
> In kSA 400, [add an Image Streamer filter](https://docs.atomscale.ai/gateway/rheed/ksa-400.md#set-up). Then, in the
> integration, set **Frame Rate (FPS)** to the rate kSA 400 streams at. **kSA 400 Computer**
> and **Image Streamer Port** default to this computer and port 4000; change them if kSA 400
> runs elsewhere or streams on another port. See [kSA 400](https://docs.atomscale.ai/gateway/rheed/ksa-400.md).

> [tab] Tool logs
>
> Use **Tool Log Streamer**. Set **Watch Path** to the folder your tool software writes logs
> to, and **Format** to match them. Vendor formats such as Veeco MOLLY's **EpiTrend** need
> nothing more; see [Supported Formats](https://docs.atomscale.ai/gateway/tool-state.md#supported-formats). Logs already in the
> folder aren't uploaded unless you turn on Show advanced settings and
> Upload Existing Files.
>
> **CSV** logs also need a parsing schema, which tells Atomscale which columns to read.
> [Ask the Gateway assistant to draft and check it](https://docs.atomscale.ai/gateway/tool-state/setup.md#set-up-with-the-assistant) using a sample log.
> To write it yourself, click Create new parsing schema and edit the example using the
> [Parsing Schema Reference](https://docs.atomscale.ai/gateway/tool-state/parsing-schema.md).

> [tab] Ellipsometer
>
> Use **FilmSense FS-1**. Set **Instrument Host** to the ellipsometer's address (by default
> `169.254.1.1`), and click Test connection. See [FilmSense FS-1](https://docs.atomscale.ai/gateway/filmsense.md).

> [tab] Files
>
> Use **File Watcher**. Set **Watch Path** to the folder the instrument saves files to. Files
> already in the folder aren't uploaded unless you turn on Upload Existing Files. See
> [File Watcher](https://docs.atomscale.ai/gateway/file-watcher.md).

**4. Create a Growth Instrument and link your integrations**

A **Growth Instrument** represents one growth system, such as your MBE chamber. Linking your
integrations to it lets Atomscale group their data into growths. A new organization has none
yet, so create one first:

1. On the **Integrations** page, click None in an integration's **Growth Instrument**
   column, then click + New growth instrument at the bottom of the list. The
   **Growth Instruments** page opens.
2. Click + Growth Instrument. Enter an **Instrument Label**, the name you'll choose in
   Atomscale, such as "Main Facility MBE #2", and an **Instrument Name**, its make and model.
   Click Create.
3. Click Integrations in the rail, click None again, and choose the new instrument. Choose the
   same instrument for every integration on this growth system.

If your growth system already has an instrument in Atomscale, skip to the last step and choose
it. If you run several growth systems, create one for each.

> [!WARNING]
>
> Link each integration before its first run. Data that arrives earlier isn't linked, so
> Atomscale can't group it into a growth.

> [accordion] No Growth Instrument column, or an error?
>
> * **No Growth Instrument column**: the column appears once the workstation is connected to
>   Atomscale. Check the connection and wait a few seconds.
> * Integration not found on this gateway: the integration was added moments ago. Wait
>   about 15 seconds and choose again.
>
> You can also link integrations from the web app: click Gateways in the icon rail on the
> far left, and open this workstation. See [Finding Your Data](https://docs.atomscale.ai/gateway/data.md).

**5. Start the integrations and check your data**

On the **Integrations** page, click each integration and click Start Integration. Then run
a growth, or acquire as usual, and check your data:

> [tab] RHEED
>
> Start the integration while your RHEED software is acquiring. Its **Health** section shows
> Healthy once frames arrive, and the growth appears on
> **Monitor**. Growths shorter than 10 minutes are removed from **Monitor** afterward.

> [tab] kSA 400
>
> **Activity Logs** show Image stream connected, then
> Data item opened: kSA 400 @ …. The growth appears on **Monitor**.
> Growths shorter than 10 minutes are removed from **Monitor** afterward.

> [tab] Tool logs
>
> When your tool software starts a new log, **Activity Logs** show
> Upload started for …. The log appears on the
> **Data** page as **Tool Logs - …**.
>
> Its chart starts empty: right-click the chart, or click its gear, and click + next to a
> channel to plot it.

> [tab] Ellipsometer
>
> When a measurement starts, **Activity Logs** show
> FilmSense run started. The run appears on the
> **Data** page.

> [tab] Files
>
> Save a new file into the folder. **Activity Logs** show
> Upload completed for …. The file appears on the
> **Data** page.

If data is still missing, follow
[Trace the Data Path](https://docs.atomscale.ai/gateway/reference/troubleshooting.md#trace-the-data-path).

## Leave It Running

* Close the window instead of quitting. Atomscale keeps running in the system tray (click **^** next to the clock if you don't see its icon).
* Stay signed in to Atomscale. Uploads pause while no one from the owning organization is signed in.
* After a reboot, sign in to Windows as the same user.

The app updates itself. For shared or unattended computers, see [Keep the Gateway Running](https://docs.atomscale.ai/gateway/keep-running.md).

## You're All Set

> [!TIP]
>
> This computer is now an Atomscale gateway. From here on, your instruments' data streams to
> Atomscale as it's collected, with nothing to upload by hand. Growths appear live on **Monitor**,
> with RHEED and tool data side by side, and everything else lands on **Data**. If the network
> drops, the gateway keeps collecting and uploads the backlog when it reconnects.

> [card] [Watch a growth live](https://docs.atomscale.ai/platform/reference/monitoring.md)
>
> Follow RHEED video, growth metrics, and tool state on **Monitor** while a growth runs.

> [card] [Analyze a growth](https://docs.atomscale.ai/platform/get-started/analyze.md)
>
> Ask the assistant questions about a growth and build an analysis notebook.

> [card] [Find your data](https://docs.atomscale.ai/gateway/data.md)
>
> Find recordings and see how RHEED and tool logs from one growth are grouped.

> [card] [Check on this computer remotely](https://docs.atomscale.ai/gateway/remote-management.md)
>
> See its status and manage its integrations from the web app's **Gateways** page.


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