Fast, fun, ActivityPub server, powered by Go.
Go to file
tsmethurst 65bf285637 requirements.txt for RtD 2021-07-31 17:54:50 +02:00
.github fix lint errors 2021-03-20 19:44:18 +01:00
cmd/gotosocial Swagger (#124) 2021-07-31 17:49:59 +02:00
docs requirements.txt for RtD 2021-07-31 17:54:50 +02:00
example add trusted proxy for parsing client IPs (#115) 2021-07-26 16:15:36 +02:00
internal Swagger (#124) 2021-07-31 17:49:59 +02:00
scripts Api/v1/statuses (#11) 2021-04-19 19:42:19 +02:00
testrig Link hashtag bug (#121) 2021-07-29 13:18:22 +02:00
web frontpage template tweaks (#99) 2021-07-13 18:40:47 +02:00
.gitignore Oidc (#109) 2021-07-23 10:36:28 +02:00
.readthedocs.yaml requirements.txt for RtD 2021-07-31 17:54:50 +02:00
CONTRIBUTING.md put version in binary properly (#73) 2021-06-28 12:17:20 +02:00
Dockerfile build and bundle admin console + web assets (#119) 2021-07-27 14:45:27 +02:00
GETTINGSTARTED.md allow custom ports for webserver and le 2021-07-24 18:55:24 +02:00
LICENSE add docs and a bunch of other stuff 2021-02-28 15:17:18 +01:00
PROGRESS.md Block/unblock (#96) 2021-07-11 16:22:21 +02:00
README.md Link parsing (#120) 2021-07-28 11:42:26 +02:00
build.sh put version in binary properly (#73) 2021-06-28 12:17:20 +02:00
dockerbuild.sh Db tls (#102) 2021-07-19 18:03:07 +02:00
dockerpush.sh Db tls (#102) 2021-07-19 18:03:07 +02:00
generateswagger.sh Swagger (#124) 2021-07-31 17:49:59 +02:00
go.mod Link parsing (#120) 2021-07-28 11:42:26 +02:00
go.sum Link parsing (#120) 2021-07-28 11:42:26 +02:00
lint.sh Swagger (#124) 2021-07-31 17:49:59 +02:00
mkdocs.yml Swagger (#124) 2021-07-31 17:49:59 +02:00
version put version in binary properly (#73) 2021-06-28 12:17:20 +02:00

README.md

GoToSocial

patrons receives

GoToSocial is an ActivityPub social network server, written in Golang.

GoToSocial provides a lightweight, customizable, and safety-focused entryway into the Fediverse, and is comparable to (but distinct from) existing projects such as Mastodon, Pleroma, Friendica, and PixelFed.

With GoToSocial, you can keep in touch with your friends, post, read, and share images and articles, without being tracked or advertised to.

Features

Federation

Because GoToSocial uses the ActivityPub protocol, you can Keep in touch not only with people on your home server, but with people all over the Fediverse, seamlessly!

Mastodon API compatible

Full support for modern, elegant apps like Tusky and Pinafore.

Tusky Pinafore
An image of GoToSocial in Tusky An image of GoToSocial in Pinafore

Granular post settings

You should be able to choose how your posts can be interacted with:

  • Local-only posts.
  • Rebloggable/boostable toggle.
  • 'Likeable' toggle.
  • 'Replyable' toggle.

Easy customizability for admins

  • Adjustable post length.
  • Media upload size settings.

LetsEncrypt

Built-in, automatic support for secure HTTPS with LetsEncrypt.

Light footprint and good performance

Plays nice with lower-powered machines like Raspberry Pi, old laptops and tiny VPSes.

Easy to deploy

No external dependencies apart from a database. Just download the binary + assets (or Docker container), and run.

HTTP signature authentication

Protect your data.

User Safety

Strict privacy enforcement for posts and strict blocking logic.

Subscribeable and shareable allow/denylists for federation

Import and export allowlists and denylists. Subscribe to community-created blocklists (think Adblocker, but for federation!).

Various federation modes

  • 'Normal' federation; discover new servers.
  • Allowlist-only federation; choose which servers you talk to.
  • Zero federation; keep your server private.

Wishlist

These cool things will be implemented if time allows (because we really want them):

  • Groups and group posting!
  • Reputation-based 'slow' federation.
  • Community decision making for federation and moderation actions.
  • User-selectable custom templates for rendering public posts:
    • Twitter-style
    • Blogpost
    • Gallery
    • Etc.

Design Ethos

One of the key differences between GoToSocial and other federated server projects is that GoToSocial doesn't include an integrated client front-end (ie., a webapp).

Instead, like Matrix.org's Synapse project, it provides only a server implementation, some static pages, and a well-documented API. On top of 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.

Status

Work began on the project around February 2021, and the project is still in prerelease.

At this point, GoToSocial is already deployable and very useable, and it federates cleanly with most other Fediverse servers.

For a detailed view on what's implemented and what's not, and progress made towards a first v0.1.0 (beta) release, see here.

Getting Started

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

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

Contact

For questions and comments, you can reach out to tobi on the Fediverse here, mail admin@gotosocial.org, or join our Matrix channel at #gotosocial:superseriousbusiness.org.

For bugs and feature requests, please check to see if there's already an issue, and if not, open one or use one of the above channels to make a request (if you don't have a Github account).

Credits

The following libraries and frameworks are used by GoToSocial, with gratitude 💕

Image Attribution

Sloth logo made by Freepik from www.flaticon.com.

Sponsorship + Funding

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

License

GoToSocial is licensed under the GNU AGPL v3 LICENSE.

Copyright (C) 2021 the GoToSocial Authors.