microblog.pub/README.md
2018-05-18 20:41:41 +02:00

2.4 KiB

microblog.pub

microblog.pub

Version Build Status License

A self-hosted, single-user, ActivityPub powered microblog.

Features

  • Implements a basic ActivityPub server (with federation)
    • Compatible with Mastodon and others (Pleroma, Hubzilla...)
    • Also implements a remote follow compatible with Mastodon instances
  • Expose your outbox as a basic microblog
  • IndieAuth endpoints (authorization and token endpoint)
    • U2F support
    • You can use your ActivityPub identity to login to other websites/app
  • Admin UI with notifications and the stream of people you follow
  • Attach files to your notes
    • Privacy-aware upload that strip EXIF meta data before storing the file
  • No JavaScript, that's it, even the admin UI is pure HTML/CSS
  • Easy to customize (the theme is written Sass)
  • Microformats aware (exports h-feed, h-entry, h-cards, ...)
  • Exports RSS/Atom feeds
  • Comes with a tiny HTTP API to help posting new content and performing basic actions
  • Deployable with Docker

Running your instance

Installation

$ git clone
$ make css

Configuration

$ make password

Deployment

$ docker-compose up -d

You should use a reverse proxy...

Development

The most convenient way to hack on microblog.pub is to run the server locally, and run

# One-time setup
$ pip install -r requirements.txt
# Start the Celery worker, RabbitMQ and MongoDB
$ docker-compose -f docker-compose-dev.yml up -d
# Run the server locally
$ FLASK_APP=app.py flask run -p 5005 --with-threads

Contributions

PRs are welcome, please open an issue to start a discussion before your start any work.