BLEX

KO | EN

gitlite — search

#python #typescript #golang #android #rust #deep-learning #docker #macos #awesome #cli #kubernetes #pytorch #mcp #ios

(★ 54)

Blog, Let me Express — Writing-first publishing platform.

BLEX Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
  An open-source platform for writing, publishing, and running a blog.
</p>

<p align="center">
  English · <a href="README.ko.md">한국어</a>
</p>

BLEX is built around one workflow: write, organize, publish, and maintain a
blog over time. It provides a browser editor and administration tools, with
Docker as the supported deployment path.

## Project focus

- **Writing and publishing:** rich-text editing, drafts, autosave recovery,
  revision history, previews, cover images, and scheduled publishing
- **Content management:** authors, series, tags, search, static pages, comments,
  likes, and pinned posts
- **Blog operations:** branding, notices and banners, users and roles, webhooks,
  and Telegram integration
- **Open publishing:** RSS, sitemaps, canonical and Open Graph metadata, public
  Markdown, and a Developer API with scoped tokens

GitHub and Google login, TOTP two-factor authentication, and English and Korean
product UI are included. User-authored content is always displayed as written.

## Run locally with Docker

Requirement: Docker.

```bash
docker run -d \
  --name blex \
  --restart unless-stopped \
  -p 20002:80 \
  --mount source=blex-db,target=/var/lib/blex \
  --mount source=blex-media,target=/app/resources/media \
  -e BLEX_SQLITE_DB_PATH=/var/lib/blex/db.sqlite3 \
  -e SECRET_KEY=local-preview-only-change-me \
  -e CIPHER_KEY=local-only-cipher-key-32-charsxx \
  -e DEBUG=TRUE \
  -e ENABLE_ENGLISH_UI=TRUE \
  -e SITE_URL=http://localhost:20002 \
  baealex/blex:latest

docker logs blex
```

The command uses `DEBUG=TRUE` so BLEX works over local HTTP. This is a
development setting and must not be carried into a public deployment.

Open `http://localhost:20002`, then use the `Initial setup URL` from
`docker logs blex` to create the first administrator. The `blex-db` and
`blex-media` volumes keep the database and uploads when the container is
replaced.

### Production deployment

Use unique secrets, set `DEBUG=FALSE`, and configure `SITE_URL`,
`ALLOWED_HOSTS`, and `CSRF_TRUSTED_ORIGINS` for the public domain. Place an
HTTPS proxy in front of BLEX and back up both volumes. The
[Self-hosting Guide](docs/SELF_HOSTING.md) covers the complete setup and upgrade
path.

## Publishing interfaces

| Path | Purpose |
| --- | --- |
| `/rss` | RSS feed |
| `/sitemap.xml` | Sitemap index |
| `/llms.txt` | Optional agent entry point |
| `/@{username}/{post_url}.md` | Public post as Markdown |
| `/api/developer/v1/docs` | Developer API documentation |

## Development

Requirements:

- Python 3.12+
- Node.js 22 (22.22.2+), 24 (24.15+), or 26+
- npm

```bash
npm install
npm run server:migrate
npm run dev
```

Open `http://localhost:8000`.

## Documentation

- [Self-hosting Guide](docs/SELF_HOSTING.md)
- [Development Convention](docs/DEV_CONVENTION.md)
- [Translation Guide](docs/TRANSLATION_GUIDE.md)

## License

[MIT License](LICENSE)

BLEX

BLEX Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

BLEX

BLEX Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README