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

# Troubleshooting

> Find the fix for common gateway, integration, upload, and data problems

Start with the integration's **Health** section, including its health summary if it shows one, then its **Activity Logs** and its **Advanced** view on the gateway. Then find the symptom below. If you contact Atomscale support, include the [logs](https://docs.atomscale.ai/gateway/reference/files-and-logs.md#collecting-logs-for-support).

You can also [ask the Gateway assistant to investigate](https://docs.atomscale.ai/gateway/assistant.md#diagnose-a-setup-or-upload-problem). Name the integration that isn't collecting or uploading and when the problem started.

## Trace the Data Path

When data is missing, find the stage that has not completed before restarting or changing configuration:

```text theme={null}
Source → collection → local buffer → upload → cloud processing → sample association
```

| Stage | What to check | Next reference |
| - | - | - |
| Collection | Is the integration running and receiving frames or reading the intended log? Check its health verdict, **Activity Logs**, and source settings. | [Integrations](https://docs.atomscale.ai/gateway/integrations.md), [RHEED sessions](https://docs.atomscale.ai/gateway/rheed/sessions.md#troubleshooting), [Tool logs](https://docs.atomscale.ai/gateway/tool-state/setup.md#troubleshooting) |
| Local buffer | Is data waiting on disk? Inspect **Upload Queue** and the integration's **Advanced** view. | [Uploads and Buffering](https://docs.atomscale.ai/gateway/uploads.md) |
| Upload | Are uploads paused, failing, or falling behind? Check sign-in, connection sharing, and backlog diagnostics. | [When Uploads Fall Behind](https://docs.atomscale.ai/gateway/uploads.md#when-uploads-fall-behind) |
| Cloud processing | Is the item present in **Data Catalog** but still processing or in error? Inspect the item's status before expecting derived results. | [Finding Your Data](https://docs.atomscale.ai/gateway/data.md#where-to-look) |
| Sample association | Is the item present but absent from the growth? Include unassigned items in the catalog and check **Growth Instrument** and **Physical Sample**. | [Link Integrations to the Growth Instrument](https://docs.atomscale.ai/gateway/data.md#link-integrations-to-the-growth-instrument) |

The browser's **Remote Command Activity Log** reports command outcomes; it is not the local
integration activity log or proof that data reached the cloud. See [Remote Management](https://docs.atomscale.ai/gateway/remote-management.md).
Keep unsent queues intact while investigating. Uninstalling an integration removes its queued data.

## Setup and Gateway

| Symptom | What to do |
| - | - |
| Setup says We were not able to connect to the Atomscale platform | Check the network and proxy, or use a Connection Sharing Hub. See [Connection](https://docs.atomscale.ai/gateway/first-run.md#1-connection) and [Network Requirements](https://docs.atomscale.ai/gateway/reference/network.md). |
| Setup is stuck on Preparing your organization… | Wait a minute. If it gives up, contact Atomscale support. |
| The gateway shows Offline in the web app | Check that Atomscale is running, someone from the owning organization is signed in, and the computer can reach Atomscale. See [Keep the Gateway Running](https://docs.atomscale.ai/gateway/keep-running.md). |
| Gateway access denied, or Uploads paused | Sign in with an account from the organization that owns the gateway. See [Sign In](https://docs.atomscale.ai/gateway/first-run.md#3-sign-in). To move a gateway to another organization, contact Atomscale support. |
| The same workstation appears twice on the Gateways page | Its local data was erased, so it registered as a new gateway. Remove the old, offline entry. See [Replacing a Workstation](https://docs.atomscale.ai/gateway/installation.md#replacing-a-workstation). |
| Collection stopped after a reboot | The app starts only after the Windows user signs in. See [Unattended Collection](https://docs.atomscale.ai/gateway/keep-running.md#unattended-collection). |
| Collection stopped after people left the lab | **Sign out when idle** is on. See [Shared Computers](https://docs.atomscale.ai/gateway/keep-running.md#shared-computers). |
| The app restarted by itself to install an update | That's [Automatic Updates](https://docs.atomscale.ai/gateway/updates.md#automatic-updates); turn it off to control when updates install. |

## Integrations and Uploads

| Symptom | What to do |
| - | - |
| Quarantined, Error, Paused, Protocol error, or Revoked | See [Statuses](https://docs.atomscale.ai/gateway/integrations.md#statuses). |
| An update failed and rolled back | See [When an Update Fails](https://docs.atomscale.ai/gateway/updates.md#when-an-update-fails). |
| The upload queue keeps growing, Backpressure, or expired or dropped deliveries | See [When Uploads Fall Behind](https://docs.atomscale.ai/gateway/uploads.md#when-uploads-fall-behind). |
| Hub unreachable or another Connection Sharing problem | See [Connection Sharing](https://docs.atomscale.ai/gateway/connection-sharing.md#troubleshooting). |
| An integration needs admin access and won't start | See [Integration Admin Access](https://docs.atomscale.ai/gateway/admin-access.md#when-it-needs-repair). |

## RHEED

| Symptom | What to do |
| - | - |
| Can't find the camera, or no frames with Network (GVSP Tap) | See [Network Capture troubleshooting](https://docs.atomscale.ai/gateway/rheed/network-capture.md#troubleshooting). |
| Producer or camera errors with Standard (GenTL) | See [Standard Capture troubleshooting](https://docs.atomscale.ai/gateway/rheed/camera.md#troubleshooting). |
| Running but no data items, or growths split or merged | See [Recording Sessions troubleshooting](https://docs.atomscale.ai/gateway/rheed/sessions.md#troubleshooting). |

## Tool Logs and Data

| Symptom | What to do |
| - | - |
| Parsing errors, or a log isn't picked up | See [Set Up Tool Logs troubleshooting](https://docs.atomscale.ai/gateway/tool-state/setup.md#troubleshooting). |
| A growth isn't on the **Monitor** page, or a tool log isn't with its RHEED | Link both integrations to the same **Growth Instrument**. See [Finding Your Data](https://docs.atomscale.ai/gateway/data.md). |
| RHEED and tool state don't line up in time | See [Timestamps and Clocks](https://docs.atomscale.ai/gateway/data.md#timestamps-and-clocks). |


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