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

# Atomscale Gateway Guide

> Turn a lab workstation into a gateway that streams instrument and tool data to Atomscale in real time

A **gateway** is a lab computer running the Atomscale desktop app next to an instrument. The app runs small connector programs called **integrations** that read from a source such as your RHEED camera, your tool's log folder, or an ellipsometer, and it uploads everything they collect to Atomscale. In the Atomscale web app, each gateway appears on the **Gateways** page, where you can check on it and manage it remotely.

The desktop app needs Windows 10 or later. On Windows 7 or XP, install the **Atomscale CLI** instead, which runs the kSA 400, Tool Log Streamer, and File Watcher integrations as a Windows service. See [Windows 7 and XP](https://docs.atomscale.ai/gateway/installation.md#windows-7-and-xp).

> [!NOTE]
>
> This guide is also built into the desktop app: open Documentation in the app to read it
> without internet access. For the rest of the platform, see
> [docs.atomscale.ai](https://docs.atomscale.ai).

## Choose a Task

| You need to… | Start here |
| - | - |
| Set up a new workstation | [Set Up Atomscale](https://docs.atomscale.ai/gateway/set-up.md) |
| Set up or troubleshoot an integration in chat | [Gateway Assistant](https://docs.atomscale.ai/gateway/assistant.md) |
| Set up a Windows 7 or XP computer | [Windows 7 and XP](https://docs.atomscale.ai/gateway/installation.md#windows-7-and-xp) |
| Connect a RHEED camera | [RHEED Camera](https://docs.atomscale.ai/gateway/rheed.md), or [kSA 400](https://docs.atomscale.ai/gateway/rheed/ksa-400.md) to read from kSA 400's Image Streamer |
| Collect tool logs | [Tool Logs](https://docs.atomscale.ai/gateway/tool-state.md) |
| Stream ellipsometry from a FilmSense FS-1 | [FilmSense FS-1](https://docs.atomscale.ai/gateway/filmsense.md) |
| Upload files an instrument saves to a folder | [File Watcher](https://docs.atomscale.ai/gateway/file-watcher.md) |
| Connect a workstation without internet access | [Connection Sharing](https://docs.atomscale.ai/gateway/connection-sharing.md) |
| Find a recording or join RHEED and tool logs | [Finding Your Data](https://docs.atomscale.ai/gateway/data.md) |
| Manage a workstation from the browser | [Remote Management](https://docs.atomscale.ai/gateway/remote-management.md) |
| Find why data is missing | [Trace the Data Path](https://docs.atomscale.ai/gateway/reference/troubleshooting.md#trace-the-data-path) |

## How It Works

```text theme={null}
 Lab workstation (gateway)
┌─────────────────────────────────────┐
│ Atomscale desktop app               │
│ ┌──────────────┐  ┌──────────────┐  │
│ │ RHEED Camera │─►│ Gateway      │  │
│ └──────────────┘  │ runtime:     │  │
│ ┌──────────────┐  │ disk queue + │  │
│ │ Tool Log     │─►│ uploads      │  │
│ │ Streamer     │  └──────┬───────┘  │
│ └──────────────┘         │          │
└──────────────────────────┼──────────┘
            HTTPS uploads ▼ ▲ commands
                    ┌─────────────┐
                    │  Atomscale  │
                    └─────────────┘
```

* **Integrations** run as separate programs on the workstation. Each reads one source, such as a camera or a log folder, and hands its data to the desktop app. Integrations never connect to Atomscale themselves and hold no credentials.
* **The gateway runtime** in the desktop app queues data on disk and uploads it over HTTPS as the signed-in user. If the network drops, integrations keep collecting and the backlog uploads later.
* **Atomscale** stores the data, analyzes it as it arrives, groups RHEED and tool logs from the same growth onto one physical sample, and relays commands you send from the web app's **Gateways** page.

## Get Started

To set up a new workstation from start to finish, follow [Set Up Atomscale](https://docs.atomscale.ai/gateway/set-up.md).

## Terms

| Term | Meaning |
| - | - |
| **Gateway** | A computer running the Atomscale desktop app or the Atomscale CLI, identified by a device ID and owned by one Atomscale organization. |
| **Integration** | One installed connector, such as **RHEED Camera (GenTL)** or **Tool Log Streamer**. You can install several copies of the same integration, each with its own configuration. |
| **Data item** | One recording in Atomscale. Each RHEED stream and each tool log becomes its own data item. |
| **Growth Instrument** | The growth system an integration serves, set on the desktop app's **Integrations** page or the gateway's page in the web app. |
| **Upload queue** | The on-disk buffer where an integration's data waits until it is uploaded. |
| **Hub / Outpost** | [Connection Sharing](https://docs.atomscale.ai/gateway/connection-sharing.md) roles that let a workstation without internet access upload through another gateway on the same network. |
| **Integration admin access** | A Windows setting that lets integrations that need administrator rights, such as RHEED network capture, run with them. See [Integration Admin Access](https://docs.atomscale.ai/gateway/admin-access.md). |


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