Skip to content

Install

Jump to bottom
wrm3 edited this page Jul 6, 2026 · 1 revision

Install

Consumers install a precompiled, per-OS installer — not a source build. Download the installer for your OS from Download, run it once, and the app installs persistently and updates itself in place (see Updating).

Windows

  1. Download Gald3r.Throne_0.2.0_x64-setup.exe (NSIS) — or the .msi for managed deployments.
  2. Run it. If SmartScreen warns "Windows protected your PC", click More info → Run anyway (the build is unsigned for now — see Download).
  3. The app installs per-user and appears in the Start menu.

MSI, for managed / silent deployment:

msiexec /i "Gald3r.Throne_0.2.0_x64_en-US.msi" /qn

Linux

AppImage (portable, any distro):

chmod +x Gald3r.Throne_0.2.0_amd64.AppImage
./Gald3r.Throne_0.2.0_amd64.AppImage

Debian / Ubuntu (.deb):

sudo apt install ./Gald3r.Throne_0.2.0_amd64.deb
# then launch from your app menu, or:
gald3r-throne

macOS

A signed macOS .dmg/.app is not attached to v0.2.0 yet. Until it is, build from source — see the README. When the signed build lands, install by dragging the app into /Applications; for an unsigned interim build use right-click → Open to clear Gatekeeper once.

Launch with gald3r throne

If you have the gald3r Agent CLI installed, a single global command finds and launches the installed Throne app on any OS:

gald3r throne            # locate and launch the installed app
gald3r throne --where    # print the resolved app path

If the app isn't installed, the command prints the download URL.

First run

  • Launch from your OS app menu (Windows / macOS) or desktop launcher (Linux). The window opens at 1280×800 (minimum 960×600).
  • The status strip shows File-first mode (always on) plus Valhalla: offline and Yggdrasil: offline — both optional backends are off by default, which is correct behavior, not an error.
  • You'll be shown the project / workspace picker. Click Select a folder and choose any directory:
    • A gald3r-managed project (has .gald3r/.identity) opens straight into the dashboard.
    • A Workspace-Control owner (has .gald3r/linking/workspace_manifest.yaml) opens with the Workspace panel populated.
    • Anything else reports "not a gald3r project" — Throne never creates .gald3r/ automatically (that's a separate setup workflow).

See Usage for a tour of the app's panels.

Backend-configured surfaces (optional)

Most surfaces are fully local. A few — Company Identity, Team, Team Admin, and Mission Control — are cloud-backed and read/write through the gald3r world_tree API. They show a clear "No backend configured" banner unless a backend URL is available (dev builds proxy /api/v1/* to a local world_tree; packaged builds need VITE_API_BASE_URL baked in at build time). Everything else works offline.

Gald3r Throne v0.2.0

Gald3r Throne

v0.2.0

Clone this wiki locally