Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time



FOSSA Status


SilverBlog is a lightweight blog project based on Python3.

Why SilverBlog

  • Simple, compact blog system.
  • Easy to install and deploy.
  • Complete Rss support.
  • Modular design, easy to add, delete.
  • No database design.
  • With a static page generation module comparable to Hexo, you can run on Github Page with only one line of commands.
  • Native support for Linux can be deployed on any platform through Docker.
  • Has Android, IOS, WEB client.
  • Full GitHub Flavored Markdown support

How to install

We support freebsd,debian(ubuntu), fedora, alpine, arch linux for direct deployment. For other systems, please use Docker deployment. You can install SilverBlog directly using the installation script:

bash -c "$(curl -fsSL"

Custom installation name:

bash -c "$(curl -fsSL" -n silverblog


bash -c "$(curl -fsSL"

If you are using a new install of Ubuntu 18.04, you may need to modify the /etc/apt/source.list file and add universe and multiverse software sources after main, which will ensure the installation will run smoothly. A correct configuration is as follows:

deb bionic main restricted universe multiverse

deb bionic-updates main restricted universe multiverse

deb bionic-backports main restricted universe multiverse

deb bionic-security main restricted universe multiverse

You can select a theme in silverblog-theme, then use ./ to install the configuration and configure it correctly in the configuration file below.

This installation script uses the nginx + uwsgi execution mode by default. You can put the auto-generated nginx_config file into your nginx package's website configuration directory. If you need to use a third-party web client, don't forget to modify the CORS configuration in nginx_config.


Start operation

You can run SilverBlog using tools such as Tmux or Screen. You just need to execute python3 to open your blog.

You can use the --control parameter to run the management server.

If you need to run blogs and manage servers simultaneously in a container, use the python3 ​​--control --docker command. We do not recommend this method of operation if conditions permit.

Keep running and monitoring your blog

Containers started with docker-compose are automatically restarted. You just need to ensure that the Docker service starts automatically when it starts up.

You can configure your server using the file in the install directory, which requires root privileges. It is consistent with the recommended method below.



bash -n silverblog -u silverblog

SilverBlog recommends using a NodeJS-based monitor: pm2

For the installation of pm2 see tj/n: Node version management and pm2 - Quick Start

you just have to run:

pm2 start pm2.json

It is possible to automatically restart SilverBlog after updating files or program errors.

You can also use:

pm2 startup
pm2 save

Enables your SilverBlog to start automatically when the system is powered on.

How to use administrative scripts

You can use ./ -h at any time to get the help information for the SilverBlog management module.

Directly typing ./ will enter the whiptail build's graphical environment.

Using the github page feature

You can use git clone https://${personal_access_tokens}${your_repo} static_page to initialize your Github Page repository.

Don't forget to initialize your submit user information using the following command:

cd static_page
git config ""
git config "your name"

Next, you just need to execute the Build static page command. The system will automatically generate a static page and submit it to the github page.

You can try using the /example/.travis.yml script for automated submission.

Use client management server

Warning! If you need to use the SilverBlog client, make sure you use the https security protocol. Using http is like telling a password to a hacker! This may compromise your server security!

You can download the latest android client at

You can compile and deploy the IOS client yourself.

You can use SilverCreator ( to manage your blog.

You can execute ./ qrcode to generate the automated configuration QR code.

Switch to developer preview

SilverBlog is now available as a developer preview version. You can switch from git checkout --track -b origin/develop to the developer preview in the repository root directory. This version may have undiscovered bugs. Please use it with caution.

Participate in development

We welcome you to report issue or pull request on GitHub of the SilverBlog project.

If you are not yet familiar with GitHub's Fork and Pull development model, you can read the GitHub Documentation for more information.

We recommend that you use the Chinese language to raise an issue, and attach an English translation below to make it easier for non-Chinese native language developers to read and understand.


Thanks to @Liqueur Librazy for providing the demo program server for this project.

Thanks Jetbrains for providing a free All product IDE for this project

Give a cup of coffee and let me better maintain this project?

Your donation will make me work better for this project.