lore

module
v0.10.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 9, 2026 License: Apache-2.0

README

Lore

Keep your knowledge close.
A small, self-hosted, Markdown-first wiki for documentation.

Lore gives you a focused place to write, organize, search, and share documentation. It runs as a single Go application backed by PostgreSQL and includes authentication, revision history, search, media, collaboration, and administration.

The same binary can also publish Markdown as a read-only static documentation site without PostgreSQL or a running Lore server.

Screenshots

Documentation dashboard

Lore dashboard populated with the project documentation

Markdown editor

Lore Markdown editor showing documentation in split view

Quick start

Start Lore with Docker Compose:

docker compose -f deploy/compose.yaml up -d

By default, Lore is available at:

http://localhost:8080

On a fresh database, open Lore and create the first administrator through the setup page.

For production deployments, authentication, Kubernetes, static sites, and other configuration, see the documentation.

Common settings

Environment variables use the LORE__ prefix.

Setting Default What it changes
LORE__LISTEN_ADDRESS 127.0.0.1:8080 Address and port Lore listens on.
LORE__PUBLIC_URL http://localhost:8080 Externally visible URL of the Lore installation.
LORE__DATABASE_URL PostgreSQL connection URL.
LORE__LOCAL_LOGIN false Enables the local recovery login alongside the configured authentication mode.

See the configuration guide for all settings and authentication options.

Documentation

The full documentation is published at:

gi8lino.github.io/lore

License

Lore is licensed under the Apache License, Version 2.0.

Directories

Path Synopsis
internal
app
ascii
Package ascii contains predicates for the ASCII character classes used by Lore.
Package ascii contains predicates for the ASCII character classes used by Lore.
cli
Package cli defines Lore's command tree and binds command-line flags to application operations.
Package cli defines Lore's command tree and binds command-line flags to application operations.
httpresponse
Package httpresponse writes shared HTTP response formats used across transport layers.
Package httpresponse writes shared HTTP response formats used across transport layers.
icons
Package icons exposes the icon catalogs used by the Lore interface.
Package icons exposes the icon catalogs used by the Lore interface.
pdf
Package pdf sends standalone page documents to an external PDF renderer.
Package pdf sends standalone page documents to an external PDF renderer.
revision
Package revision compares persisted page revisions for display.
Package revision compares persisted page revisions for display.
secrets
Package secrets encrypts sensitive application settings with a deployment-managed key.
Package secrets encrypts sensitive application settings with a deployment-managed key.
subpages
Package subpages parses and renders the configurable {{subpages}} page function.
Package subpages parses and renders the configurable {{subpages}} page function.
scripts
generate-icons command
Command generate-icons creates Lore's Lucide icon picker catalog.
Command generate-icons creates Lore's Lucide icon picker catalog.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL