Installation

Instrata is available for Windows, Linux, and macOS.
You can download the latest release from the official GitHub releases page or the direct links in the sections below.

IMPORTANT

On Windows and macOS, system warnings may appear because Instrata binaries are not code-signed.
These alerts are expected and safe to bypass when installing from the official GitHub releases.
See the Windows and macOS sections below for OS-specific instructions.

Windows

Download formats:

• instrata-x86_64.msi - standard Windows installer
• instrata-x86_64-setup.exe - alternative executable installer

Installation steps:

1. Download either the .msi or .exe file.
2. Run the installer and follow the setup wizard.

   IMPORTANT

   On Windows, you may see a “Windows protected your PC” or SmartScreen warning when running the .msi or .exe installer. Instrata is an open-source project and the binaries are not code-signed, which triggers these alerts. This is expected and does not indicate malware. You can safely continue by selecting More info → Run anyway if you downloaded the installer from the official GitHub releases.

3. Launch Instrata from the Start Menu or desktop shortcut.

Linux

Download formats:

• instrata-x86_64.AppImage - portable, executable file
• instrata-x86_64.deb - for Debian and Ubuntu-based distributions
• instrata-x86_64.rpm - for Fedora, RHEL, or openSUSE

Installation steps:

Using AppImage

1. Download the .AppImage file.
2. Make it executable:

   chmod +x instrata-x86_64.AppImage

3. Run it directly:

   ./instrata-x86_64.AppImage

Using DEB or RPM

1. Install via your package manager:

   # Debian/Ubuntu
   $ sudo apt install ./instrata-x86_64.deb
   
   # Fedora/RHEL/openSUSE
   $ sudo rpm -i instrata-x86_64.rpm

2. Run it directly:

   $ instrata

macOS

Download formats:

• instrata-arm64.dmg - drag-and-drop installer
• instrata-arm64.app.tar.gz - portable app archive

Installation steps:

1. Download the .dmg file and open it.
2. Drag Instrata.app into your Applications folder.
3. Launch it from Launchpad or Finder.

If macOS blocks the app (unverified developer warning), open System Preferences → Security & Privacy → General and click Open Anyway.

IMPORTANT

On macOS, you may see a message stating that “Instrata.app can’t be opened because it is from an unidentified developer.”
The app is not signed with an Apple Developer ID, which causes this warning.
This is normal for open-source software.
To run it, open System Settings → Privacy & Security, then click Open Anyway next to the warning.
Always ensure you downloaded from the official GitHub releases.

Updating

Instrata automatically informs you of new versions with an in-app notification for most installation formats. When available, you can update directly from within the application.

Alternatively, you can manually download and install the latest version from the official GitHub releases. Your existing guides and settings should remain intact after updating.

Next Steps

Once installed, continue to the Usage guide to learn how to create and export your first documentation sequence.