Friendly mirror of mostly for doing automated Docker builds in the short-term.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
decentral1se 2067494af4
Merge branch 'main' of into main
4 weeks ago
.github fix lint errors 4 months ago
cmd/gotosocial put version in binary properly (#73) 4 weeks ago
docs try some doc changes 5 months ago
example Api/v1/accounts (#8) 4 months ago
internal put version in binary properly (#73) 4 weeks ago
scripts Api/v1/statuses (#11) 3 months ago
testrig Testrig fixes (#50) 1 month ago
web Fix 404 contact (#74) 4 weeks ago
.drone.yml Add Drone config 4 weeks ago
.gitignore new styling for frontpage, update login and authorize templates (#46) 1 month ago put version in binary properly (#73) 4 weeks ago
Dockerfile put version in binary properly (#73) 4 weeks ago put version in binary properly (#73) 4 weeks ago
LICENSE add docs and a bunch of other stuff 5 months ago Deletes+unboosts (#52) 1 month ago Add Drone config 4 weeks ago put version in binary properly (#73) 4 weeks ago
go.mod add web handler to testrig 1 month ago
go.sum new styling for frontpage, update login and authorize templates (#46) 1 month ago
version put version in binary properly (#73) 4 weeks ago


patrons receives

Build Status

Federated social media software.

Sloth logo made by Freepik from

GoToSocial is a Fediverse server project, written in Golang. It provides an alternative to existing projects such as Mastodon, Pleroma, Friendica, PixelFed etc.

One of the key differences between GoToSocial and those other projects is that GoToSocial doesn't include an integrated client front-end (ie., a webapp). Instead, like the's Synapse project, it provides only a server implementation, some static web pages for profiles and posts, and a well-documented API. On this API, developers are free to build any front-end implementation or mobile application that they wish.

Because the server implementation is as generic and flexible/configurable as possible, GoToSocial provides the basis for many different types of social media experience, whether Tumblr-like, Facebook-like, or Twitter-like.

Features Wishlist

A grab-bag of things that are already included or will be included in the project if time allows:

  • Various federation modes, including reputation-based 'slow' federation, 'normal' federation, allowlist-only federation, and zero federation.
  • Local-only posting, and granular post settings including 'rebloggable/boostable', 'likeable', 'replyable'.
  • Character limit for posts that's easy for admins to configure (no messing around in the source code).
  • Groups and group posting!
  • Built-in, automatic LetsEncrypt support (no messing around with Nginx or Certbot).
  • Good performance on lower-powered machines like Raspberry Pi, old laptops, tiny VPSes (the test VPS has 1gb of ram and 1 cpu core).
  • Subscribeable and shareable allowlists/denylists for federation.

Implementation Status

Things are moving on the project! As of June 2021 you can now:

  • Build and deploy GoToSocial as a binary, with automatic LetsEncrypt certificate support built-in.
  • Connect to the running instance via Tusky or Pinafore, using email address and password (stored encrypted).
  • Post/delete posts.
  • Reply/delete replies.
  • Fave/unfave posts.
  • Post images and gifs.
  • Boost stuff/unboost stuff.
  • Set your profile info (including header and avatar).
  • Follow people/unfollow people.
  • Accept follow requests from people.
  • Post followers only/direct/public/unlocked.
  • Customize posts with further flags: federated (y/n), replyable (y/n), likeable (y/n), boostable (y/n) -- not supported through Pinafore/Tusky yet.
  • Get notifications for mentions/replies/likes/boosts.
  • View local timeline.
  • View and scroll home timeline (with ~10ms latency hell yeah).
  • Stream new posts, notifications and deletes through a websockets connection via Pinafore.
  • Federation support and interoperability with Mastodon and others.

In other words, a deployed GoToSocial instance is already pretty useable!

For a detailed view on progress made towards a v0.1.0 (beta) release, see here.

Getting Started

Proper documentation for running and maintaining GoToSocial will be forthcoming in the first prerelease.

For now (if you want to run it pre-alpha, like a beast), check out the quick and dirty getting started guide.


For questions and comments, you can reach out to tobi on the Fediverse here or mail


Currently, this project is funded using Liberapay, to put bread on the table while work continues on it.

If you want to sponsor this project, you can do so here! <3

Image Attribution

Logo made by Freepik from