Skip to main content

logo

openwrite is a minimalist blogging platform built for writing freely, hosting independently, and publishing without noise.

PyPI - Downloads PyPI - Version License: AGPL-3.0-or-later pythonver


Features

  • Multiple blogs per user(limit defined in .env)
  • Single-blog mode
  • Supports sqlite and mysql databases
  • Upload images to local storage or bunny cdn
  • Drafts
  • Simple markdown editor in posting
  • Discover section
  • Privacy:
    • Set if blog should be indexed in search engines
    • Set if post should be listed in "Discover" section
    • Set if username should appear in post page (anonymous posts)
  • Lightweight
  • No tracking, only data collected is anonymized(hashed) IP for post view counting and likes
  • Custom CSS per blog
  • Federation using ActivityPub protocol
  • Likes system
  • Posts importing from xml/csv
  • Blog themes
  • Gemini protocol
  • Statistics per post
  • Multilanguage (currently English and Polish)
  • Custom favicon per blog
  • Subpages per blog
  • Valkey support
  • Post tags, filtering
  • Optional comments per post
  • Auto save during typing

Installation

  1. To install openwrite, clone it with pip:
pip install openwrite
  1. Then run:
openwrite init
  1. Answer few questions about your instance to generate .env and create all necessary directories.
  2. Run:
openwrite run

to run it in foreground or:

openwrite run -d

to run it in background.

  1. Default user is admin with password openwrite. You can (and should!) change it in your dashboard. Enjoy!

Local development over HTTP

For http://localhost:8081, set these values in .env:

DOMAIN=localhost:8081
IP=127.0.0.1
PORT=8081
GEMINI=no

When working from a checkout, install it with ./venv/bin/python -m pip install -e . so changes in this folder are used by the CLI. Run ./venv/bin/openwrite debugrun (or ./venv/bin/openwrite run) and open http://localhost:8081. DOMAIN must match the hostname and port in the browser, without a protocol prefix. For a custom local hostname such as openwrite.local, use DOMAIN=openwrite.local:8081 and point that hostname to 127.0.0.1 in your hosts file. Restart the server after changing .env.

Both commands serve plain HTTP. In an HTTPS deployment, terminate TLS at a reverse proxy and forward the original host and scheme with X-Forwarded-Host and X-Forwarded-Proto so browser links use the public address.

Metadata

Release files for openwrite 0.17.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for openwrite 0.17.2
File Size Uploaded Provenance Actions
openwrite-0.17.2.tar.gz 1.3 MB Without provenance Details for openwrite-0.17.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for openwrite 0.17.2
File Interpreter ABI Platform Actions
openwrite-0.17.2-py3-none-any.whl Python 3 none any Details for openwrite-0.17.2-py3-none-any.whl

Total release size: 2.7 MB

Release files / openwrite-0.17.2.tar.gz

Download URL openwrite-0.17.2.tar.gz
Size 1.3 MB
Tags Source
SHA-256 checksum
How to use checksums
e2272199a600953563329d304d01f534838534240fa523eacc8015d3e52fa576
BLAKE2b-256 checksum
How to use checksums
d7760613191bce6b36e4ee062448a88d23dcc06b2a73bc26a14c94038b023008
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.10

Release files / openwrite-0.17.2-py3-none-any.whl

Download URL openwrite-0.17.2-py3-none-any.whl
Size 1.4 MB
Tags Python 3
SHA-256 checksum
How to use checksums
6a6fbecba1078d496f90988d8f7dc6a6931a919be0b465ad65d93c077ea165ab
BLAKE2b-256 checksum
How to use checksums
2401c1ff607f78977b525c2e16c7d40131848a70c8184512967af0586d7c8965
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.10

Security for openwrite 0.17.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page