===============================================================================
NOW DIALING ... :: CARRIER DETECTED
===============================================================================
█ █ █ █ ████ █████ ████ █ █ ████ █ █████ █ █ █ █
█ █ █ █ █ █ █ █ █ █ █ █ █ █ █ ██ █ █ █
█████ ███ ████ ███ ████ █ █ ████ █ █ █ █ █ ███
█ █ █ █ █ █ █ █ █ █ █ █ █ ██ █ █
█ █ █ █ █████ █ █ ███ █ █████ █████ █ █ █ █
::: A SUPER HIGH SPEED INTERNET BULLETIN BOARD AS SINGLE BINARY :::
No PHP. No /var/www. No CGI. No FPM. No node_modules. No JavaScript.
Just one self-contained, statically-linked executable that beams data
right from your PostgreSQL cluster into beautiful, modern,
server-side rendered HTML5 and CSS.
100% JavaScript-Free Browsing
Modern HTML5 and CSS
Runs Anywhere
Zero Loose Files Spilled On Disk
Themeable Like It's 1998
And More!
Hyperuplink, it's the forum software
your wife told you not to worry about.
And it, too, really whips the Llama's ass.
===============================================================================
Hyperuplink is a modern internet bulletin board reimagined as a single, dependency-free binary, supporting PostgreSQL clusters and without any runtime dependencies, 100% JavaScript free, and based on modern HTML5/CSS.
More info here and at hyperup.link.
Hyperuplink is actively developed on tty.fail. GitHub is a mirror that provides pre-built binaries.
- Go
- PostgreSQL server
- Redis-compatible server (Redis, Valkey, KeyDB, ...)
- Optional: S3-compatible object store (e.g. MinIO)
Clone this repository
- from tty.fail (primary):
$ git clone https://tty.fail/hyperuplink/hyperuplink.git
- from GitHub (mirror):
$ git clone https://github.com/hyperuplink/hyperuplink.git
Then cd into the cloned directory and build:
$ make build
The self-contained binary will be available at ./build/hyperuplink and can be
moved wherever you please.
You can check the version of a build with:
$ ./build/hyperuplink -v
Hyperuplink is configured through a single TOML file. A complete, commented
reference can be found in hyperuplink.toml. Almost
everything else, like the board name, theme, colorscheme, permissions, groups,
is configured live from the /admin panel once the board is running and you've
created your admin account.
Note: For S3 attachment storage, use a private bucket. The gated attachment route serves objects with server-side credentials, so a private bucket keeps uploads from being guessable at the storage layer.
Point the binary at your configuration file and launch it:
$ ./build/hyperuplink -c "file:///etc/hyperuplink.toml"On startup Hyperuplink connects to PostgreSQL, runs any pending migrations,
starts the web server and the background worker, and starts serving. Open your
browser at the address you configured (e.g. http://localhost:3000), sign up
with the e-mail you listed under [Users] PromoteAdmin, and you'll be set up as
the board's first administrator.
During development you can build and run in a single step:
$ make run
To stop the server, send it a SIGINT (Ctrl-C) or SIGTERM. This shuts the web
server and worker down cleanly.
A huge, heartfelt thank-you to nielssp/classic-stylesheets, whose gorgeous retro CSS made my life enormously easier when starting out with Hyperuplink and gave the whole thing its unmistakable old-school look. Go star it.
Copyright © 2025-2026 マリウス
Hyperuplink is released under Version 1.1 of the SEGV License, whose full text is included in the LICENSE file. Go read it, there will be a test on it on Monday.