About

Mb is as a micro blog server that aims to be small, fast and self contained. It was heavly inspired by this project that was writen in V. I rewrote it in Go in a mutch cleaner fashion and added features. The main simularaties that are left is the philosophy and the visuals (which are improved for mobile).

Features

• Easy deploy with Docker or single binary
• Docker image of just 8 MB!
• Simple authentication
• Full markdown support
• Fully self contained with no external dependencies
• 100% Javascript free
• RSS feed
• Custom Youtube and Spotify embeds
• Build in media manager for images, video and audio
• Build in backups
• Mobile friendly
• Light weight and performant
• Tag and text search
• Private/draft posts
• ...

Dev Setup

Dev dependencies

Latest version of Go and the following codegen tools. Use the latest version or the version currently used in the repo.

go install github.com/a-h/templ/cmd/templ@latest

go install github.com/sqlc-dev/sqlc/cmd/sqlc@latest

Air is optional but strongly recommended.

go install github.com/cosmtrek/air@latest

Deploying

Docker

This is an expample to run mb with Docker. You can you can use it as a base for your own config.

Env

See Configuration for more info.

# .env
MB_AUTH_PASSWORD=test123
MB_TIMEZONE=Europe/Brussels
MB_LOGO=" ▄▄▄·▪   ▐ ▄ ▄▄▄ .\n▐█ ▄███ •█▌▐█▀▄.▀·\n ██▀·▐█·▐█▐▐▌▐▀▀▪▄\n▐█▪·•▐█▌██▐█▌▐█▄▄▌\n.▀   ▀▀▀▀▀ █▪ ▀▀▀ "
MB_RIGHTS=pine32.be
MB_LINK=https://pine32.be
MB_MESSAGE="A funny little cycle."
MB_HOST=https://mb.pine32.be

Compose file

# docker-compose.yml
services:
  mb:
    image: pineapple217/mb:latest
    container_name: mb
    restart: unless-stopped
    volumes:
      - ./data:/app/data
      # this makes sure the datetimes are right on the container
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    env_file:
      - .env
    ports:
      - 3000:3000

docker compose up -d

Configuration

Environment variables

variable	info	default
MB_AUTH_PASSWORD	The password used when login in /auth	random generated password that will be printed on startup
MB_TIMEZONE	Timezone used to when showing dates of posts	Timezone of machine the webserver is running on
MB_LOGO	Logo displayed on the top of the main page. Make sure to use \n for line breaks	MB logo, see: https://patorjk.com/software/taag/#p=display&f=Elite&t=MB
MB_RIGHTS	Name of the right holder thingy	mb.dev just a placeholder
MB_LINK	Link displayed at the top fo the page	https://mb.dev link does not exist
MB_MESSAGE	Message displayed at the top of the page	Created without any JS.
MB_HOST	The full host url where the blog is hosted. For ex. https://mb.pine32.be	http://localhost:3000

Performance

TODO

profiling util

https://github.com/sevennt/echo-pprof

http://127.0.0.1:3000/debug/pprof/

go tool pprof -http=:8080 .\profile