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.

hexon logo

Self-host hexon

v1.0.0

Self-hosted GUI for managing Hexo blogs

ReleaseOpen SourceGPL-3.0
Updated7 months ago
LanguageTypescript
Setup difficultyModerate
Stars
151
Port
5777 (HTTP server)
Requires
Git, Node.js, Pnpm
Install with Build from Source
Hexon home screen showing the web interface

What is hexon?

Hexon provides a web-based GUI for Hexo static site generators. It handles post and page management, front-matter templates, and runs git commands for content synchronization. The software requires git, Hexo, and Node.js to be pre-installed on the host system. It runs as a Node.js server with a Koa backend and Vue 3 frontend, listening on port 5777 by default. PM2 integration is available for production deployments. Authentication uses JWT tokens with a built-in password reset command. The project is licensed under GPL-3.0 and developed by winwin2011.

Should you self-host hexon?

hexon scores 44/100 on selfhost.directory (how scoring works) and ranks #17 of 24 in Blogging. It has 151 GitHub stars.

It shipped 1 stable release in the past year. The latest, v1.0.0, came out on 21 March 2026.

Setup is moderate: expect some configuration beyond a single command. It is GPL-3.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Typecho (66/100, 12 457 stars). It scores higher overall, so compare the two before you pick. See hexon vs Typecho side by side.

Features

  • Custom script management
  • Front-Matter Template
  • Password authentication with reset
  • PM2 production support
  • Post and page management

hexon README

How to install hexon

Install hexon with Build from Source

git, Hexo, Node.js, pnpm
git clone https://github.com/gethexon/hexon --depth 1
cd hexon
pnpm install
pnpm run setup

For plain Node.js:

pnpm start

For production with PM2:

pnpm prd

Requires git, Hexo, and Node.js pre-installed and working

How to configure hexon

  • pnpm prdStart Hexon with PM2 for production

    Start Hexon with PM2 for production

  • pnpm resetpwdReset password

    Reset password

  • pnpm run setupInstall and configure Hexon

    Install and configure Hexon

  • pnpm scriptManage custom scripts

    Manage custom scripts

  • pnpm startStart Hexon with Node.js

    Start Hexon with Node.js

hexon releases & version history

FAQ

How to configure Apache reverse proxy for Hexon?

Add AllowEncodedSlashes NoDecode in your VirtualHost configuration, and add nocanon at the end of the ProxyPass setting.

404 Error - What causes 404 errors when accessing Hexon?

404 errors are typically caused by reverse proxy configuration mistakes (e.g., Nginx or Apache config). Verify by using curl directly on the server to request assets without any reverse proxy.

More in Content Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…