Skip to main content

Install and update

Get the installer from the official download page and check the system, architecture, and version. Which platforms and formats the page offers depends on the current public release.

Before installing​

Confirm the download came from the official site, the file finished downloading, and the target system and processor architecture match. Choose the correct macOS installer for Apple Silicon or Intel; check the architecture for Windows and Linux too.

If your computer is managed by an organization, installation and network permissions may be restricted by its policies; handle it the way the organization requires.

Installing per system​

  • macOS: follow the installer's instructions to place the app in Applications, then launch it. If the system blocks it, check the file's origin, integrity, and the exact warning first; do not ignore malware or corrupted-file warnings.
  • Windows: run the official installer that matches your system and follow the wizard; record the exact text of any security prompt or install error.
  • Linux: install or run the format provided on the release page; handle dependency errors for that specific distribution and message.

Do not disable system protections, run repair scripts of unknown origin, or delete private data just to work around an ordinary launch problem.

First launch​

View and copy a valid activation key in the dashboard, follow the desktop onboarding to authorize, then set up either Newton sign-in and balance or a BYOK or local model connection. The whole flow is in Quick start.

Before and after updating​

Back up the workspace and any settings you want to keep, finish or cancel running tasks, quit the app, and update according to the official release notes. After updating, check profile cards, past conversations, and the model connection.

The availability and delivery of Stable are described in Versions and release channels. The desktop app only queries Stable updates, settings has no channel switcher, and that is not an installation fault.

Download or update failures​

Recheck the official version, platform, and error message. Fetch the file again if the download was incomplete; if the network, system management, or permissions block access, work through the specific cause. Keep a working installation and a data backup before deciding what to do next.

When you need support, provide the system, architecture, app version, installer source, and an error screenshot with private data masked; see Contact support.