Skip to content

Install Chipforge

Download the Chipforge desktop app and install it on your computer, then sign in with the account from your invitation. The current version is 0.5.4.

You install Chipforge once. After that, it updates itself, so you don’t usually need to come back here for each new version. You do come back if you open the tunnel to a remote server yourself.

  • Check that your computer meets the system requirements.
  • Find your invitation email. It comes from no-reply@chipforge.studio and contains your username, which is your email address, and a temporary password.

If your computer can’t reach the internet, ask your Chipforge contact for the installer.

Chipforge for Windows comes in two forms. Both install the same app.

  1. Download the installer, and check the download.

  2. Run the installer and follow its prompts.

  3. If the Microsoft Edge WebView2 Runtime isn’t already on your computer, the installer installs it. Windows 11 includes it.

  4. Start Chipforge from the Start menu.

When Chipforge starts, it shows the Projects page. The Companion status in the top bar shows Connecting… while the app starts its companion, then Companion once it’s ready.

Before you install, check that the file you downloaded is the one Chipforge published. Work out its SHA-256 checksum, using the name of the file you downloaded:

Terminal window
Get-FileHash .\Chipforge_0.5.4_x64-setup.exe -Algorithm SHA256

The checksum must match the one for that file below. Letter case doesn’t matter. If it doesn’t match, delete the file, download it again, and if it still doesn’t match, contact support.

File SHA-256 checksum
Chipforge_0.5.4_x64-setup.exe 9be3ec448bb4fc862d7e0e054d1436dba5a360d0e816a8ec3b3efe0ee48817f9
Chipforge_0.5.4_x64_en-US.msi 7a896e1df7e5dd55d7b21ff59860aa5d77e3dc3c51efce5cb7b3af7ed3e06fef
Chipforge_0.5.4_aarch64-fat.dmg c48d3d13f4fd699a1e9be7b58e95a1a28f64a973532a58b64c66eb762afff4c8
Chipforge_0.5.4_amd64.deb 648bb3718d861da3a6f8bcd959f2ed7e8b3db653bd92b9ff3e1c69396f15a292

You can look around the Projects page without signing in, but you need to sign in to create or open a project.

  1. Select Sign in in the top bar. If you opened a page that needs an account, select Sign in with your organization instead.

    Chipforge opens your default web browser at the Chipforge sign-in page. Its address ends in amazoncognito.com. While Chipforge waits for you, the top-bar button reads Signing in…; select it again if you need to reopen the sign-in page.

  2. Enter your email address and the temporary password from your invitation.

  3. Choose a new password that meets the page’s requirements.

  4. If your browser asks whether to open Chipforge, allow it. The app comes back to the front and finishes signing you in.

  5. Close the browser tab. It can stay on the sign-in form even after the sign-in worked.

Chipforge keeps you signed in when you quit and reopen it. It stores your sign-in encrypted on your computer, with its key in your operating system’s keychain.

If signing in doesn’t finish, see Troubleshooting.

  1. Select your email address in the top bar.

  2. Select Sign out.

Chipforge removes your sign-in from this computer and reloads. Your browser may open a page that says you’re signed out of Chipforge; you can close it.

Chipforge checks for updates while it runs and installs them when you quit. See Update Chipforge.