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.
Before you begin
Section titled “Before you begin”- Check that your computer meets the system requirements.
- Find your invitation email. It comes from
no-reply@chipforge.studioand 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.
Download and install the app
Section titled “Download and install the app”Chipforge for Windows comes in two forms. Both install the same app.
Chipforge_0.5.4_x64-setup.exeinstalls Chipforge for your Windows account and doesn’t need administrator rights. Use this one unless your IT team says otherwise.Chipforge_0.5.4_x64_en-US.msiis the Windows Installer package, for administrators who deploy software centrally. Chipforge’s own updates use the per-user installer instead: see Update Chipforge.
-
Download the installer, and check the download.
-
Run the installer and follow its prompts.
-
If the Microsoft Edge WebView2 Runtime isn’t already on your computer, the installer installs it. Windows 11 includes it.
-
Start Chipforge from the Start menu.
Chipforge for macOS runs on Macs with Apple silicon. The disk image, Chipforge_0.5.4_aarch64-fat.dmg, includes the companion, so you can run open-source simulators such as Icarus Verilog and Verilator on your Mac.
AMD Vivado and Intel Quartus Prime don’t run on macOS. To synthesize designs from a Mac, run them on a Linux server.
-
Download the disk image, and check the download.
-
Open the disk image.
-
Drag Chipforge into your Applications folder.
-
Start Chipforge from your Applications folder.
Chipforge for Linux is a .deb package, Chipforge_0.5.4_amd64.deb, for 64-bit x86 computers, such as Ubuntu 22.04 or later.
-
Download the package, and check the download.
-
Install the package with
apt, which also installs the libraries it needs:Terminal window sudo apt install ./Chipforge_0.5.4_amd64.deb -
Start Chipforge from your applications menu.
Install the package rather than unpacking it: installing registers Chipforge to receive the sign-in link from your browser.
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.
Check the download
Section titled “Check the download”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:
Get-FileHash .\Chipforge_0.5.4_x64-setup.exe -Algorithm SHA256shasum -a 256 Chipforge_0.5.4_aarch64-fat.dmgsha256sum Chipforge_0.5.4_amd64.debThe 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 |
Sign in
Section titled “Sign in”You can look around the Projects page without signing in, but you need to sign in to create or open a project.
-
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. -
Enter your email address and the temporary password from your invitation.
-
Choose a new password that meets the page’s requirements.
-
If your browser asks whether to open Chipforge, allow it. The app comes back to the front and finishes signing you in.
-
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.
Sign out
Section titled “Sign out”-
Select your email address in the top bar.
-
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.
Keep Chipforge up to date
Section titled “Keep Chipforge up to date”Chipforge checks for updates while it runs and installs them when you quit. See Update Chipforge.