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.

GitHub
silicon logo

Self-host silicon

0.1.5

Lightweight personal knowledge base with Markdown editing

BetaOpen SourceOther
Updated5 months ago
LanguagePython
Setup difficultyModerate
MobileResponsive
Stars
266
Port
5000 (HTTP web interface)
Docker
docker.io/bityard/silicon
Install with Docker Compose
Full desktop view of Silicon Notes showing page content and sidebarFull desktop view with CodeMirror editor openMobile layout view of Silicon Notes

What is silicon?

Silicon Notes is a lightweight personal knowledge base built for low-friction note-taking. It offers plaintext Markdown editing that renders to HTML, code block syntax highlighting, two-way page linking, full-text and title search, revision history, and a sidebar table of contents. The interface works well on mobile and includes built-in documentation. Since it lacks any authentication, it must run on a trusted network or behind a VPN. The app is a Python Flask project with an optional CodeMirror editor. Data lives in SQLite and can be exported to or imported from JSON. You can deploy it via Docker, Docker Compose, or locally with uv and poe.

Should you self-host silicon?

silicon scores 43/100 on selfhost.directory (how scoring works) and ranks #27 of 42 in Knowledge Management. It has 266 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 moderate: expect some configuration beyond a single command. An official Docker image is available. It is Other-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Project N.O.M.A.D. (85/100, 41 107 stars). It scores higher overall, so compare the two before you pick. See silicon vs Project N.O.M.A.D. side by side.

Features

  • Bi-directional links
  • Built-in documentation
  • CodeMirror editorOptional; can be disabled via SILICON_EDITOR=textarea
  • Data Export/ImportWork in progress; supports full export/import via CLI commands
  • Full-Text Search
  • Markdown editing
  • No built-in authenticationExplicitly stated as having no auth
  • Page history
  • Syntax highlighting
  • Table of Contents

silicon README

How to install silicon

Install silicon with Docker Compose

Environment variables
FLASK_RUN_HOST, FLASK_RUN_PORT, INSTANCE_PATH, WERKZEUG_DEBUG_PIN, SECRET_KEY, SILICON_EDITOR

cd deploy/docker-local docker-compose up

Uses docker-compose.yaml from deploy/docker-local directory

How to configure silicon

  • FLASK_RUN_HOST127.0.0.1Host address to bind the development server to

    Host address to bind the development server to

  • FLASK_RUN_PORT5000Port for the development server

    Port for the development server

  • INSTANCE_PATHDirectory where Silicon data (including the SQLite database) is stored

    Directory where Silicon data (including the SQLite database) is stored

  • SECRET_KEYString used in session cookies; should be 16+ random characters for production

    String used in session cookies; should be 16+ random characters for production

  • SILICON_EDITORSet to 'textarea' to disable CodeMirror and use a standard textarea element

    Set to 'textarea' to disable CodeMirror and use a standard textarea element

    values: textarea

  • WERKZEUG_DEBUG_PINPIN to enable the Werkzeug debug console; set to 'off' to disable

    PIN to enable the Werkzeug debug console; set to 'off' to disable

silicon releases & version history

More in Wikis

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…