For 2.x, use version
0.3.0 of this plugin. Version
1.x and beyond only
support Hexo v3.x.
Local use vs deployment
This plugin was originally designed as a local editor -- you run hexo locally, use
hexo-admin to author posts, and then use
hexo generate or
hexo deploy to send the generated static HTML files up to github pages or some other static server.
hexo-admin can be run on your live blog, as long as you're using a non-static hosting service such as Heroku, DigitalOcean, etc. Static hosting services such as Github pages and Surge.sh does not support running hexo-admin from your live site.
If you're using Hexo admin from your live blog, you should definitely set up a password (see below) -- otherwise anyone will be able to edit your content.
1. Setup hexo & create a blog
npm install -g hexo cd ~/ hexo init my-blog cd my-blog npm install
2. Install the admin & start things up
npm install --save hexo-admin hexo server -d open http://localhost:4000/admin/
The UI should be pretty discoverable -- let me know if you can't find something.
4. Password protection
If you're using Hexo admin on your live server, you want some password
protection. To enable this, you just add a few config variables to your hexo
admin: username: myfavoritename password_hash: be121740bf988b2225a313fa1f107ca1 secret: a secret something
password_hash is the bcrypt hash of your password. The
secret is used
to make the cookies secure, so it's a good idea to have it be long and
A utility in Hexo admin's Settings can hash your password and generate the
section for you. Start Hexo and go to
Settings > Setup authentification
and fill out your information. Copy the generated YAML into your
Once that's in place, start up your hexo server and going to
require you to enter your password.
5. Custom post metadata
To add and edit your own post metadata with the admin interface, add the
metadata variable and your custom variables to your hexo
metadata: author_id: defaultAuthorId language:
You can provide default values that will be used to initialize the metadata of a new post. These can be either primitives or arrays.