Web UI

GhostFS includes a web-based file manager that runs alongside the server. It provides a browser interface for uploading, downloading, renaming, and managing files on your GhostFS server.

Download

curl -fSL https://ghostfs.com/release/latest/ghostfs-webui.tar.gz -o ghostfs-webui.tar.gz

Setup

Extract the web UI to a directory on your server:

mkdir -p ~/.ghostfs/webui
tar -xzf ghostfs-webui.tar.gz -C ~/.ghostfs/webui

Usage

Pass --http-static pointing to the extracted directory when starting the server or web command:

With the server command

ghostfs server --root ~/.ghostfs/root --web --http-static ~/.ghostfs/webui

This starts both the RPC server and the HTTP web server. The web UI will be available at http://localhost:8080.

Standalone web server

ghostfs web --root ~/.ghostfs/root --http-static ~/.ghostfs/webui

Custom port

ghostfs web --root ~/.ghostfs/root --http-static ~/.ghostfs/webui --http-port 9090

With TLS

ghostfs web --root ~/.ghostfs/root --http-static ~/.ghostfs/webui \
  --key server.key --cert server.crt

Or with automatic Let's Encrypt certificates:

ghostfs web --root ~/.ghostfs/root --http-static ~/.ghostfs/webui \
  --acme --acme-domain example.com --acme-email admin@example.com

Notes

• The web UI is a static SvelteKit application — no Node.js runtime is needed on the server.
• Authentication is handled by the GhostFS auth system. Users log in with their GhostFS credentials.
• If --http-static is omitted, the HTTP server runs without a UI (API-only mode).