Coolify GUI

Native cross-OS desktop client for self-hosted Coolify. Single-pane overview of every Resource across all your Projects and Environments, one-click Restart / Deploy, drill-down detail (env, compose, logs), and a daily image-freshness check across docker / docker-compose resources — without juggling browser tabs.

Screenshots

Screenshots live under docs/screenshots/ (placeholder — not yet populated).

Download

Pre-built binaries are published on the GitHub Releases page (placeholder — point to your fork until upstream releases exist):

• macOS: .dmg (Apple Silicon + Intel)
• Windows: .msi
• Linux: .AppImage, .deb

Quickstart

1. Install and launch.
2. Paste your Coolify URL (e.g. https://acme.coolify.dev) and a Bearer token.
3. Hit Test connection, then Save.

Required token scope

In the Coolify dashboard, create a Personal Access Token with:

• read:sensitive — list resources + read environment variable values.
• deploy — Restart / Stop / Deploy actions.

write and root are not required. The token is stored in your OS keyring (Keychain / Credential Manager / Secret Service); the webview never holds it.

Build from source

Prerequisites: Rust, Node 22, pnpm 9, and the platform Tauri prereqs (macOS / Linux / Windows).

pnpm install
pnpm tauri dev      # dev loop with HMR
pnpm tauri build    # bundle for the CURRENT OS only

pnpm tauri build produces installers under src-tauri/target/release/bundle/ for whichever OS you ran the command on — macOS gives you .dmg + .app, Windows gives .msi + .exe, Linux gives .deb + .AppImage. Tauri does not cross-compile; building all three platforms requires either three machines or CI runners (see "Cross-OS releases" below).

Quick platform notes:

• macOS — Xcode CLT (xcode-select --install).
• Linux — libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf.
• Windows — WebView2 runtime + MSVC build tools.

Release

Tag-driven cross-OS builds via GitHub Actions (.github/workflows/release.yml). Push a v* tag → matrix runs on macOS / Linux / Windows → draft GitHub Release with .dmg + .msi + .AppImage + .deb attached.

See docs/releasing.md for the full procedure, including code-signing setup (macOS Developer ID + notarization, Windows OV/EV).

Tech stack

• Tauri 2 — Rust backend + native webview shell
• SvelteKit + Svelte 5 runes — frontend
• TypeScript + Vite
• shadcn-svelte — UI primitives (dark theme only)
• svelte-sonner — toasts
• tauri-plugin-http — Rust-side reqwest (CORS-free, token never enters the webview)
• tauri-plugin-keyring — OS-native secret storage
• oci-distribution — registry digest fetch for image-freshness checks

Reference docs

• PRD.md — product requirements (origin)
• CONTEXT.md — domain glossary (Resource / Project / Instance / Status / Digest …)
• docs/superpowers/specs/2026-05-25-coolify-gui-design.md — locked design + 30-step build sequence
• AGENTS.md — conventions for agents and humans working in this repo
• docs/releasing.md — release process + code-signing