fen 5fdb34a059
CI / test (pull_request) Successful in 44s
CI / docker (pull_request) Skipped
Fix #167: align gutter numbers with actual rendered line rows (wrap ON)
paste-lines.js joined .codeline spans with '\n' text nodes that pre-wrap
renders as extra line boxes, and renumber() counted per-line span heights
(rounding) instead of real geometry, so gutter numbers drifted off their
line starts on wrapped lines. Fix: join spans with '' (blocks need no
newline text), and build one .gutline per visual row measured from the
code body's real height, placing each number at the visual row whose top
matches its .codeline's measured top. Wrap OFF path unchanged. Mobile
font-size rule added so gutter row pitch matches code rows at 375x812.
2026-09-10 12:12:00 -05:00

Palette

Palette is a fast, self-hosted pastebin. One Go binary, a SQLite database, and a web UI for sharing text and small files

Note

This project was built by AI — GLM 5.3 Flash on the Hermes Agent harness, with a human in the loop.

Features

  • Multiple files in one paste
  • Password protected pastes
  • Expir after a specified time
  • Burn after a number of views
  • Custom URLs
  • Syntax highlighting with language auto-detection (go-enry)
  • Local cookie based submission history
  • Cookie based settings
  • Themes!

Screenshots

Editor in midnight Paste view in pastel-peach
History in pastel-lavender Saved in pastel-cloud

Get Started

Docker

docker run -p 8080:8080 -v palette-data:/data git.archfox.org/poslop/palette

The SQLite database lives in the /data volume inside the container.

Docker Compose

See docker-compose.yml for a ready-to-use example with every environment variable documented, including which are required (only the /data volume) and which are optional.

Build from source

Requires Go 1.27+.

go build -o palette ./cmd/palette
./palette
# open http://localhost:8080

Configuration

Setting Default Description
PALETTE_ADDR :8080 Listen address
PALETTE_DB palette.db SQLite database path
PALETTE_MAX_TEXT 5242880 Max paste size in bytes (5 MB)
PALETTE_MAX_ITEM 26214400 Max can item size in bytes (25 MB)
PALETTE_ADMIN_KEY generated Admin key; if unset a 32-char hex key is generated and persisted to <db-dir>/admin-key (0600)
PALETTE_DEFAULT_DARK dark on Default dark mode for new visitors. Set false, 0, or off to default to light mode. Visitors who toggle dark mode keep their choice in their browser.

An /admin page exists for runtime settings, protected by a key set at install (PALETTE_ADMIN_KEY env var) and resettable locally — see API and the design docs in the wiki for details.

API

Full REST API: wiki/API. One example:

curl -X POST http://localhost:8080/api/pastes -d '{"content":"hello"}'

Design docs: wiki/design (e2e encryption, attachments & storage, cookie preferences).

License

Palette is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-only). See LICENSE.

The software is provided AS IS, without warranty of any kind, express or implied, including merchantability and fitness for a particular purpose. In no event shall the authors be liable for any claim, damages, or other liability, including without limitation any security vulnerabilities, data loss, or legal issues arising from use of the software. You use it at your own risk.

If you run a modified version of Palette as a network service, the AGPL requires you to offer your modified source code to its users.

S
Description
Fast self-hosted pastebin with small file support
Readme AGPL-3.0
106 MiB
v0.5.1
Latest
2026-09-18 18:50:51 +00:00
Languages
Go 61.1%
HTML 14.4%
JavaScript 13.3%
CSS 11%
Dockerfile 0.2%