Install BioBase

Download BioBase for Windows, macOS or Linux from your Infera account and keep it updated.

To download BioBase, open Account settings in the Infera web app and select the download for your platform in the Desktop Apps card on the Profile tab.

System requirements

	Requirement
Windows	Windows 10 or Windows 11 on a 64-bit (x64) processor
macOS	A Mac with Apple silicon or an Intel processor
Linux	A 64-bit (x64) desktop Linux system. Running the AppImage directly requires FUSE
All	An Infera account and an internet connection. The Data Agent’s model and analysis code run on remote servers

Windows

1. Run the installer

   Run BioBase-<version>-win-x64.exe. It installs BioBase for your user account and lets you choose the install folder.

2. Open BioBase

   Open BioBase from the Start menu.

The Windows installer isn’t signed with an Infera publisher certificate, so Windows may show a blue Windows protected your PC dialog that lists the publisher as unknown. If you downloaded the file from your Infera account, select More info, then Run anyway. To confirm first that the file is the one Infera published, check the download. To confirm first that the file is the one Infera published, check the download.

macOS

1. Download the disk image for your chip

   Under macOS, select Download Apple silicon DMG or Download Intel DMG. To see which chip your Mac has, open the Apple menu and select About This Mac.

2. Install BioBase

   Open the downloaded disk image and drag BioBase into Applications.

3. Open BioBase

   Open BioBase from Applications.

Linux

1. Make the AppImage executable

   chmod +x BioBase-*-linux-x86_64.AppImage
   
2. Run it

   ./BioBase-*-linux-x86_64.AppImage
   

On a system without FUSE, extract the AppImage and run the extracted program:

./BioBase-*-linux-x86_64.AppImage --appimage-extract
./squashfs-root/biobase

Check the download

Each address below describes the newest published build for one download. Open it in a browser and read version and sha256.

Download	Address
Windows	https://app.infera.bio/api/downloads/biobase/windows/meta
macOS, Apple silicon	https://app.infera.bio/api/downloads/biobase/macos/arm64/meta
macOS, Intel	https://app.infera.bio/api/downloads/biobase/macos/x64/meta
Linux	https://app.infera.bio/api/downloads/biobase/linux/x64/meta

First check that version matches the version in your filename: BioBase-0.1.1096-win-x64.exe is version 0.1.1096. If they differ, a newer build was published while you were downloading. Download again and reread the address, so you compare the file against its own hash.

Then hash the file, using its exact filename:

Windows

Open the folder that holds the download, select the address bar, type powershell, and press Enter. Then run:

(Get-FileHash .\BioBase-0.1.1096-win-x64.exe).Hash

macOS

In Terminal, from the folder that holds the download:

shasum -a 256 BioBase-0.1.1096-mac-arm64.dmg

The Intel disk image is BioBase-<version>-mac-x64.dmg.

Linux

sha256sum BioBase-0.1.1096-linux-x86_64.AppImage

The two values must match; letter case doesn’t matter. If they differ while the versions agree, don’t open the file. Delete it, download it again, and email [e-mail] if the second download also differs.

Updates

BioBase checks for a new version when it starts and periodically after that, and downloads it in the background. When the download finishes, a notice reads BioBase [version] is ready.

• Windows and Linux: select Restart to update in the notice, or in Settings under General, Software update. BioBase installs the update and reopens. If you select Later, the update installs the next time you quit BioBase.
• macOS: the update installs when you quit BioBase.

To check for a new version yourself, go to Settings, General, and select Check for updates.

If a download is refused

A refused download shows one of two messages:

• “The BioBase installer is temporarily unavailable. Try again in a moment.” Wait and retry.
• “BioBase for Windows downloads are paused until a signed release is published. Trying again does not help. Contact Infera support if you need BioBase on Windows before then.” While Windows downloads are paused, the Desktop Apps card shows “Paused until a signed release is published” under Windows, with no download button. An installed copy keeps running on its current version, and Settings under General reads “This build’s Windows update channel is closed until a signed release is published. Contact Infera support if you need to update now.” To reach support, email [e-mail]. The macOS and Linux downloads are not affected.

Next, sign in to connect BioBase to your Infera account. To remove BioBase later, see Uninstall.