Installation Guide

System Requirements

Before installing FiveForge Desktop, check that your system meets the minimum requirements.

Requirement	Minimum	Recommended
OS	Windows 10, macOS 14, Linux (x86_64)	Latest stable
RAM	4 GB	8 GB
Storage	500 MB free	2 GB free
Internet	Required	Broadband

Download FiveForge

Get the latest FiveForge Desktop release from the Download page or GitHub releases.

Windows Installation

Run the installer

Run FiveForge-Setup-x.x.x.exe

Follow the wizard

Follow the setup wizard prompts

Launch FiveForge

Launch FiveForge from the Start Menu or desktop shortcut

Dependencies install automatically

The app downloads required dependencies on first launch

Antivirus

If the installer is blocked by antivirus, add an exception. Check logs at %APPDATA%/opencode/log/ if the app fails to start.

macOS Installation

Open the disk image

Open FiveForge-x.x.x.dmg

Drag to Applications

Drag FiveForge to the Applications folder

Launch from Applications

Bypass Gatekeeper if needed

If Gatekeeper blocks it, go to System Settings > Privacy & Security and click Open Anyway

Check logs at ~/Library/Application Support/opencode/log/.

Linux Installation

AppImage:

bash

chmod +x FiveForge-x.x.x.AppImage; ./FiveForge-x.x.x.AppImage

Debian/Ubuntu:

bash

sudo dpkg -i fiveforge_x.x.x_amd64.deb; sudo apt-get install -f

Check logs at ~/.local/share/opencode/log/.

First Launch

Sign in

Select workspace

Select a workspace directory

Choose your AI provider

Choose your AI provider (no setup required)

Sidecar initializes

The sidecar initializes and the dashboard opens

Ask your first question

Start a new session and ask your first question

Sidecar

The sidecar is a local process that handles AI communication, file access, and session management.

Installing Updates

FiveForge checks for updates automatically on startup. You can also check manually in Settings > Updates. Your sessions, settings, and account are preserved.