selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

ghostboard logo

Self-host ghostboard

v3.4.3

Real-time synchronized text sharing via web and CLI

ReleaseOpen SourceMIT
Updatedlast year
LanguageHTML
Setup difficultyEasy
ThemeDark mode
Stars
342
Ports
80 (HTTP and WebSocket (bundled nginx)), 8080 (HTTP server (legacy)), 8765 (WebSocket server (legacy))
Docker
thehelpfulidiot/ghostboard-server
Install with Docker
Light mode text editorLight mode with Markdown renderingDark mode text editorDark mode with Markdown renderingProject information panelGitHub link panelConnection lost indicator

What is ghostboard?

Ghostboard provides a simple web page where text typed in one browser instantly appears in all other connected browsers, plus a CLI client for scriptable access. It runs as a Docker container (bundling nginx and the WebSocket server on port 80) or as plain Python scripts. Each URL path creates an independent board, and the UI includes dark mode, Markdown rendering, and a REST API for programmatic updates. The project explicitly states there is no encryption, so it is intended for trusted networks only.

Should you self-host ghostboard?

ghostboard scores 48/100 on selfhost.directory (how scoring works) and ranks #21 of 27 in File Sharing & Collaboration. It has 342 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is MIT-licensed and written mostly in HTML.

Its closest alternative on selfhost.directory is Nextcloud (86/100, 37 325 stars). It scores higher overall, so compare the two before you pick. See ghostboard vs Nextcloud side by side.

Features

  • Board persistence across restarts
  • Bundled nginx reverse proxy
  • Command line clientSuperseded by REST API but still supported.
  • Large text support
  • Markdown Rendering
  • Multiple independent boards
  • Real-time text synchronization
  • REST API

ghostboard README

How to install ghostboard

Install ghostboard with Docker

Environment variables
GHOSTBOARD_CLEAR_DELAY, GHOSTBOARD_MAX_TEXT_SIZE

docker pull thehelpfulidiot/ghostboard-server docker run --rm -p 8080:80 thehelpfulidiot/ghostboard-server

Bundled nginx serves HTTP and WebSocket on port 80. Multi-arch (amd64 + arm64).

How to configure ghostboard

  • GHOSTBOARD_CLEAR_DELAY300Seconds a board keeps its text after the last browser disconnects.

    Seconds a board keeps its text after the last browser disconnects.

  • GHOSTBOARD_MAX_TEXT_SIZE16777216Largest text accepted, in bytes.

    Largest text accepted, in bytes.

ghostboard releases & version history

More in File Sharing & Collaboration

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…