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

# Remote Management

> Monitor gateways and manage their integrations and settings from the Atomscale web app

Every gateway reports its status to Atomscale while someone is signed in on it. The **Gateways** page in the Atomscale web app ([app.atomscale.ai](https://app.atomscale.ai)) shows these reports, so you can check on lab workstations and manage them without being at the instrument.

Any member of the organization that owns a gateway can view it, rename it, send it commands, and remove it. Gateways of other organizations are not visible.

On **Gateways**, click **Ask assistant** to check which workstations are online or to manage integrations in chat. Name the workstation you want the [Gateway assistant](https://docs.atomscale.ai/gateway/assistant.md) to check or change.

## The Gateways List

In the web app, click Gateways in the icon rail on the far left. Its sidebar also lists a few gateways with their status.

| Column | Description |
| - | - |
| **Gateway** | The gateway's name, or its computer name if it hasn't been renamed. |
| **Status** | Online or Offline. |
| **App version** | The gateway software and version, for example `[Desktop] 1.4.2`. |
| **Operating system** | The gateway computer's operating system, for example **Windows 10 Pro 64-bit**. |
| **Integrations (Running/Installed)** | How many installed integrations are running. |
| **Last seen** | When the gateway last reported in. |
| **Last command** | When the last command that changed something was sent. The list is sorted by this column. |

Search by name or computer name, or filter by status and platform. The list refreshes every 15 seconds.

A gateway reports in every 10 seconds while someone is signed in, and counts as Online if it reported within the last 20 seconds. It shows Offline when the app is closed, no one from the owning organization is signed in, or it can't reach Atomscale. Offline gateways can't receive commands, but may still be collecting data locally.

## The Gateway Page

Click a gateway to open its page. Click its name at the top to rename it; the name is stored in Atomscale and doesn't change the computer name.

### Details

The **Original Host Name** (computer name), **Status**, **Operating system**, **App version**, and **Last Seen**.

### Actions

Available while the gateway is online.

| Action | What it does |
| - | - |
| Sync State | Asks the gateway to report its status and integration details now. |
| Check for updates | Refreshes the integration catalog and checks for integration and desktop app updates. |
| Restart to update | Appears when the gateway has downloaded a desktop app update. Restarts the app to install it; integrations pause during the restart. |

### Settings

Change the gateway's computer-wide settings while it's online. If a gateway's app is too old for a setting, the page says Update this gateway to change this setting from here.

| Setting | What it does |
| - | - |
| **Connection sharing** | Switches the gateway between Normal, Hub, and Outpost with Configure. The gateway checks the new route before switching and restores the previous settings if it can't reach Atomscale through it within 60 seconds. See [Connection Sharing](https://docs.atomscale.ai/gateway/connection-sharing.md#changing-it-from-the-web-app). |
| **Upload limits** | Upload bandwidth and concurrent uploads. See [Uploads and Buffering](https://docs.atomscale.ai/gateway/uploads.md#upload-limits). |
| **Automatic updates** | Turns the gateway's [automatic updates](https://docs.atomscale.ai/gateway/updates.md) on or off. |
| **Gateway engine runtime** | Shows whether the gateway runs on Electron or Rust, with a button to switch. Every running integration must be stopped first. Leave it unless Atomscale support asks you to switch. |

### Remote Command Activity Log

Every command sent to this gateway, with its status. Click a row to see who requested it, when it was received and finished, and the result.

| Status | Meaning |
| - | - |
| Queued | Waiting for the gateway to pick it up. |
| Received | The gateway has the command and is carrying it out. |
| Awaiting approval | A configuration change waits for someone at the gateway to accept or reject it. |
| Applying | A configuration change is being applied. |
| Completed | The command succeeded. |
| Failed | The command didn't succeed. The details explain why. |
| Rejected | The configuration change was rejected at the gateway, by a person or by validation. Nothing changed. |
| Refused | The gateway refused a connection sharing change before applying it, for example because the Hub was unreachable. |
| Rolled back | An update or connection sharing change failed and the previous state was restored. |
| Settings changed | The gateway's settings changed after you loaded them. Refresh and try again. |
| Expired | The gateway didn't pick up the command within 15 seconds, or didn't finish within 10 minutes. |
| Cancelled | The requester cancelled the command before it was applied. |

Only one command at a time can be pending for each integration, and one for the gateway itself.

### Integrations

The same integrations as on the desktop. Click one to see its details and health, or to:

* Start, stop, or resume it.
* Change its configuration (see below), including Detect for a RHEED camera.
* Install an update, or add and uninstall integrations.

The **Growth Instrument** column sets which instrument each integration serves. It decides how RHEED and tool logs group into growths; see [Finding Your Data](https://docs.atomscale.ai/gateway/data.md). You can change it even while the gateway is offline.

The gateway's page and each integration's page also show **Activity Logs**: events from the last 7 days that the gateway mirrors to Atomscale. This is separate from the [Remote Command Activity Log](#remote-command-activity-log).

Some things can only be done at the workstation: the **Upload Queue** view, clearing or opening the activity log files, browsing for folders, turning on [Integration admin access](https://docs.atomscale.ai/gateway/admin-access.md), delaying an automatic update, and approving the Windows Firewall prompt for a Hub.

## Changing Configuration Remotely

Stop the integration, edit its configuration, and click Apply Configuration. The request runs in the background, so you can leave the page.

If someone has that integration's configuration page open on the workstation, they see Remote Configuration Changes Requested and decide:

* **No unsaved edits on the workstation**: the change is accepted automatically after 60 seconds unless they click Reject Changes.
* **Unsaved edits on the workstation**: the change waits for Accept Changes or Reject Changes.
* If they close the configuration page, or don't decide before the command deadline, the change is rejected.

While a request is queued or awaiting approval, its sender can withdraw it with Cancel request.

If the gateway's settings changed after you opened the form, the request ends as Settings changed. Click Refresh settings to load the current values, then make your change again.

> [!WARNING]
>
> Other commands, including stopping or uninstalling an integration and restarting the app to
> update, run without a prompt on the workstation. Coordinate with the people running the instrument
> before stopping collection remotely.

## Removing Gateways

To remove a gateway you no longer use, such as a replaced workstation, open it and click Remove gateway. To remove several, select them in the list and choose Actions > Remove.

Removing only hides the gateway from the list. It doesn't uninstall the app or stop its integrations, and the gateway reappears the next time it reports in with someone signed in. You can't remove a gateway while it has pending or running commands.


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