Skip to main content
This page describes what the Atomscale installers do and the options they offer. To set up a computer from start to finish, follow Set Up Atomscale. Atomscale support provides both installers: the desktop app for Windows 10 and later, and the Atomscale CLI for Windows 7 and XP. Each is code-signed by Atomic Data Sciences, Inc.

Requirements

Desktop App Installer

Run the installer while signed in to Windows as the user who uses the workstation day to day. The app runs for that one user, and the gateway runs only while that user is signed in to Windows. See Keep the Gateway Running.

Installer Screens

Don’t run Atomscale with Windows’ Run this program as an administrator compatibility setting. It isn’t needed, even for RHEED network capture, which gets its rights from Integration admin access. With it on, updates install but the app may not restart afterward.

Reinstalling

If Atomscale is already installed, the installer asks how to proceed: Either option recreates the Desktop and Start Menu shortcuts. Choosing a different install location on the previous screen moves the app.
Erasing local data deletes collected data that has not been uploaded yet. Before erasing or replacing a workstation, check that each integration’s Upload Queue is empty.
If Integration admin access is on, erasing also removes it, which asks for administrator approval. If that removal does not complete, the installer keeps your local data and asks you to run setup again and approve the cleanup.

Scripted Installs

IT can install without the wizard: A scripted install doesn’t sign in. The Windows user still opens Atomscale once and completes First-Run Setup.

Uninstalling

Uninstall Atomscale from Windows Settings > Apps. The uninstaller also removes Integration admin access if it is set up, which asks for administrator approval. Queued data that has not been uploaded is lost.

Windows 7 and XP

The desktop app doesn’t run on Windows 7 or XP. On those computers, install the Atomscale CLI instead. It is a gateway that runs as a Windows service with no window, so it starts with Windows and keeps collecting whether or not anyone is signed in. It appears on the web app’s Gateways page like any other gateway.
1

Get the installer

Contact Atomscale support for the Atomscale CLI installer. One installer covers every supported Windows version and picks the build that fits the computer. A Windows 7 or XP computer without recent updates may not show the publisher.
2

Run it as an administrator

Approve the Windows prompt. On XP, run it while signed in as an administrator.
3

Connect and sign in

Setup shows one of these screens, depending on how the computer reaches Atomscale:Then paste your API key at Sign in. If the computer has no connection yet, check Sign in later with “atomscale auth login”, and once it connects, run atomscale auth login in a Command Prompt.
4

Add integrations

In the web app, open Gateways and find the CLI host: search for its computer name, and check that its App version starts with [CLI]. Open it, then add and configure its integrations there. See Remote Management.
To install without the wizard, run the installer with /S as an administrator. A silent install keeps the computer’s current connection and doesn’t sign in, so run atomscale auth login in a Command Prompt afterward. The gateway updates itself; running a newer installer also upgrades it. To uninstall, remove Atomscale CLI from Add or Remove Programs. Queued data and settings stay on the computer for a later installation.

Replacing a Workstation

A new computer, or a reinstall that erases local data, registers as a new gateway. The old entry shows as Offline on the web app’s Gateways page; remove it there (see Remote Management). Integrations, their configurations, and their Growth Instrument links do not carry over, so set them up again on the new gateway.
Before replacing a computer, click Copy configuration on each integration’s Configure page and save the text as a .json file. On the new gateway, use Import configuration to load it. Tool log parsing schemas are not included; keep your schema file as well.