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.

wikmd logo

Self-host wikmd

v1.10.7

File-based Markdown wiki with knowledge graph

ReleaseOpen SourceMIT
Updatedlast month
LanguagePython
Setup difficultyEasy
ThemeDark mode
Stars
423
Port
5000 (Port for wikmd web interface)
Docker
linbreux/wikmd
Install with Docker Compose
Wikmd homepage preview showing the wiki interface

What is wikmd?

wikmd is a simple file-based wiki system that stores all content as Markdown files on disk rather than in a database. This design makes files directly readable in terminal editors and easy to export. Users can view documents via a web interface where they are automatically converted to HTML. The software includes features like knowledge graphs, image handling, LaTeX math support, syntax highlighting, file search, and a CodeMirror editor. It runs as a self-contained service deployable via Docker.

Should you self-host wikmd?

wikmd scores 45/100 on selfhost.directory (how scoring works) and ranks #5 of 8 in Documentation Management. It has 423 GitHub stars.

It shipped 1 stable release in the past year. The latest, v1.10.7, came out on 19 August 2026.

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 Python.

Its closest alternative on selfhost.directory is HackTricks (71/100, 12 642 stars). It scores higher overall, so compare the two before you pick. See wikmd vs HackTricks side by side.

Features

  • CodeMirror editor
  • File Search
  • Git Version Control
  • Image Support
  • Knowledge GraphBeta status mentioned
  • Math/LaTeX rendering
  • Password Protectionbasic only
  • Plugin System
  • Syntax highlighting

wikmd README

How to install wikmd

Install wikmd with Docker Compose


version: "2.1" services: wikmd: image: linbreux/wikmd:latest container_name: wikmd environment: - PUID=1000 - PGID=1000 - TZ=Europe/Paris volumes: - /path/to/wiki:/wiki ports: - 5000:5000 restart: unless-stopped

How to configure wikmd

  • HOMEPAGEFile to use for the homepage

    File to use for the homepage

  • HOMEPAGE_TITLETitle for the homepage

    Title for the homepage

  • IMAGES_ROUTECustom picture upload path

    Custom picture upload path

  • PGIDGroupID for container

    GroupID for container

  • PROTECT_EDIT_BY_PASSWORDEnable password protection for editing and removing files

    Enable password protection for editing and removing files

    values: 1

  • PUIDUserID for container

    UserID for container

  • TZTimezone specification

    Timezone specification

  • WIKI_DIRECTORYCustom data path for wiki content

    Custom data path for wiki content

  • WIKI_TITLEWiki title/name displayed in GUI and browser tab

    Wiki title/name displayed in GUI and browser tab

  • WIKMD_HOST0.0.0.0Host value for the wiki server

    Host value for the wiki server

  • WIKMD_LOGGINGOptional logging toggle

    Optional logging toggle

  • WIKMD_PORTPort value for the wiki server

    Port value for the wiki server

wikmd releases & version history

More in Documentation Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…