README.md 1.27 KB
Newer Older
1 2 3 4 5
Mastodon
========

Mastodon is a federated microblogging engine. An alternative implementation of the GNU Social project. Based on ActivityStreams, Webfinger, PubsubHubbub and Salmon.

Eugen Rochko's avatar
Eugen Rochko committed
6
**Current status of the project is early development. Documentation, licensing information &co will be added later**
7

Eugen Rochko's avatar
Eugen Rochko committed
8
## Status
9

Eugen Rochko's avatar
Eugen Rochko committed
10 11 12 13 14 15 16 17 18 19 20 21 22
- GNU Social users can follow Mastodon users
- Mastodon users can follow GNU Social users
- Retweets, favourites, mentions, replies work in both directions
- Public pages for profiles and single statuses
- Sign up, login, forgotten passwords and changing password

Missing:

- Media attachments (photos, videos)
- Home timeline, notifications timeline
- UI to post, reblog, favourite, follow and unfollow
- Turn URLs in posts into links
- Upload header image for profile page
23 24 25 26 27 28

## Configuration

- `LOCAL_DOMAIN` should be the domain/hostname of your instance. This is **absolutely required** as it is used for generating unique IDs for everything federation-related
- `LOCAL_HTTPS` set it to `true` if HTTPS works on your website. This is used to generate canonical URLs, which is also important when generating and parsing federation-related IDs
- `HUB_URL` should be the URL of the PubsubHubbub service that your instance is going to use. By default it is the open service of Superfeedr