Installing the Desktop App

GreenLight DashBoard installs like any other desktop app. The packaged installer bundles the React UI, the Python backend, and the Telegram bot — there is no separate setup step.

Download

Get the latest installer from the releases page at https://greenlightdash.pro.

Choose the build for your platform:

• macOS (Apple Silicon) — GreenLight-DashBoard-<version>-arm64.dmg
• macOS (Intel) — GreenLight-DashBoard-<version>-x64.dmg
• Windows (x64) — GreenLight-DashBoard-Setup-<version>.exe
• Linux (x64) — GreenLight-DashBoard-<version>.AppImage or GreenLight-DashBoard-<version>.deb

A ZIP archive of the macOS app is also available if your IT policy blocks DMG mounts. Pick the arm64 build on Apple Silicon Macs and the x64 build on Intel Macs — both are notarised.

Install on macOS

1. Double-click the downloaded DMG to mount it.
2. Drag GreenLight DashBoard.app into the Applications folder shortcut shown in the disk image.
3. Eject the disk image.
4. Launch GreenLight DashBoard from Launchpad or Applications.

The first launch can take a few seconds while macOS verifies the signature with Apple. The build is notarised, so you will not see a Gatekeeper warning.

Install on Windows

1. Run the downloaded .exe. SmartScreen may pause for a moment because the build is signed by a small publisher; choose More info → Run anyway if it does.
2. Pick the install location and whether to create a desktop shortcut.
3. Finish the wizard. The app appears in the Start menu as GreenLight DashBoard.

Install on Linux

Two x64 builds are provided:

1. AppImage — make it executable and run it, no installation required:

   chmod +x GreenLight-DashBoard-<version>.AppImage
   ./GreenLight-DashBoard-<version>.AppImage

1. .deb (Debian / Ubuntu) — install with sudo dpkg -i GreenLight-DashBoard-<version>.deb (or double-click to open it in your software centre). The app then appears in your application menu as GreenLight DashBoard.

First launch

On first launch the app:

• Creates a data folder for boards, media, settings, and logs.
• Starts its bundled backend on port 18000.
• Opens the main window with an onboarding tour.

You can close the tour any time — it is reachable again from Help & Resources → Show Onboarding Wizard.

Where data is stored

The app stores everything under the standard per-user app-data directory:

• macOS — ~/Library/Application Support/greenlight-dashboard/
• Windows — %AppData%\greenlight-dashboard\
• Linux — ~/.config/greenlight-dashboard/

That directory holds the SQLite database (moodboard.db), the media library (media/), logs, and encrypted settings. To back up the app, copy this folder. To move to a new machine, install the app and replace the same folder.

Log files

The backend writes its log to logs/server.log inside the data folder:

• macOS — ~/Library/Application Support/greenlight-dashboard/logs/server.log
• Windows — %AppData%\greenlight-dashboard\logs\server.log
• Linux — ~/.config/greenlight-dashboard/logs/server.log

The desktop shell (window, auto-updater, licensing) logs to main.log:

• macOS — ~/Library/Logs/greenlight-dashboard/main.log
• Windows — %AppData%\greenlight-dashboard\logs\main.log
• Linux — ~/.config/greenlight-dashboard/logs/main.log

When filing a bug report, attach both files.

Uninstall

• macOS — drag the app from Applications to the Trash. The user-data folder above stays in place; remove it manually if you also want to delete your boards.
• Windows — uninstall from Settings → Apps → Installed apps. The user-data folder under %AppData%\greenlight-dashboard\ is preserved unless you delete it.
• Linux — delete the AppImage, or for the .deb run sudo apt remove greenlight-dashboard. The user-data folder under ~/.config/greenlight-dashboard/ stays unless you remove it.

Next step

Open License Activation to upgrade to Pro, or jump to the Quick Start Tutorial and start using the free tier right away.