A straight copy of GoToSocial intended to be better by enabling full support for Soapbox and other projects that the main developers refuse to work with.
Podium is an ActivityPub social network server, written in Golang.
With Podium, you can keep in touch with your friends, post, read, and share images and articles. All without being tracked or advertised to!
Podium is still ALPHA SOFTWARE. It is already deployable and useable, and it federates cleanly with many other Fediverse servers (not yet all). However, many things are not yet implemented, and there are plenty of bugs! We foresee entering beta somewhere in 2023.
Podium is a fork of GoToSocial that aims to add full support for Soapbox FE.
Documentation is at docs.gotosocial.org. You can skip straight to the API documentation here. To build from source, check the CONTRIBUTING.md file.
Podium 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.
If you've ever used something like Twitter or Tumblr (or even Myspace!) Podium will probably feel familiar to you, especially when paired with Soapbox: You can follow people and have followers, you make posts which people can favourite and reply to and share, and you scroll through posts from people you follow using a timeline. You can write long posts or short posts, or just post images, it's up to you. You can also, of course, block people or otherwise limit interactions that you don't want by posting just to your friends.
Podium does NOT use recommendation algorithms or collect data about you to suggest content or 'improve your experience'. The timeline is chronological: whatever you see at the top of your timeline is there because it's just been posted, not because it's been selected as interesting (or controversial) based on your personal profile.
Podium is not designed for 'must-follow' influencers with tens of thousands of followers, and it's not designed to be addictive. Your timeline and your experience are shaped by who you follow and how you interact with people, not by metrics of engagement!
Podium doesn't claim to be better than any other application, but it offers something that might be better for you in particular.
Because Podium uses ActivityPub, you can hang out not just with people on your home server, but with people all over the Fediverse, seamlessly.
Federation means that your home server is part of a network of servers all over the world that all communicate using the same protocol. Your data is no longer centralized on one company's servers, but resides on your own server and is shared — as you see fit — across a resilient web of servers run by other people.
This federated approach also means that you aren't beholden to arbitrary rules from some gigantic corporation potentially thousands of miles away. Your server has its own rules and culture; your fellow server residents are your neighbors; you will likely get to know your server admins and moderators, or be an admin yourself.
Podium advocates for many small, weird, specialist servers where people can feel at home, rather than a few big and generic ones where one person's voice can get lost in the crowd.
The Mastodon API has become the de facto standard for client communication with federated servers, so Podium has implemented and extended the API with custom functionality.
In short, this means full support for modern, beautiful apps like Tusky and Pinafore.
Tusky | Pinafore |
---|---|
![]() |
![]() |
If you're used to using Mastodon with Tusky or Pinafore, you'll find using Podium a breeze.
It's important that when you post something, you can choose who sees it.
Podium offers public/unlisted/friends-only/mutuals-only/and direct posts (slide in DMs! -- with consent).
It also allows you to customize how people interact with your posts:
- Local-only posts.
- Rebloggable/boostable toggle.
- 'Likeable' toggle.
- 'Replyable' toggle.
Plenty of config options for admins to play around with, including:
- Easily adjustable post length.
- Media upload size settings.
No external dependencies apart from a database (or just use SQLite!). Simply download the binary + assets (or Docker container), and run.
Podium plays nice with lower-powered machines like Raspberry Pi, old laptops and tiny $5/month VPSes.
- Built-in, automatic support for secure HTTPS with Let's Encrypt.
- Strict privacy enforcement for posts and strict blocking logic.
- Import and export allow lists and deny lists. Subscribe to community-created block lists (think Ad blocker, but for federation!).
- HTTP signature authentication: Podium requires HTTP Signatures when sending and receiving messages, to ensure that your messages can't be tampered with and your identity can't be forged.
Podium doesn't apply a one-size-fits-all approach to federation. Who your server federates with should be up to you.
- 'Normal' federation; discover new servers.
- Allow list-only federation; choose which servers you talk to.
- Zero federation; keep your server private.
Podium supports OpenID Connect (OIDC) identity providers, meaning you can integrate it with existing user management services like Auth0, Gitlab, etc., or run your own and hook GtS up to that (we recommend Dex).
Unlike other federated server projects, Podium doesn't include an integrated client front-end (i.e., a web app).
Instead, like Matrix.org's Synapse project, it provides a relatively generic backend server implementation, some beautiful static pages for profiles and posts, and a well-documented API.
On top of this API, web developers are encouraged to build any front-end implementation or mobile application that they wish, whether Tumblr-like, Facebook-like, Twitter-like, or something else entirely.
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.
All docs for installation and configuration are hosted at docs.gotosocial.org.
Since Podium is still in alpha, there are plenty of bugs. We use GitHub issues to track these. The FAQ also describes some of the features that haven't been implemented yet.
Podium works great with Tusky and Pinafore, but some other client applications still need work or have issues connecting to Podium. It's our goal to make any app that's compatible with the Mastodon API work seamlessly with Podium, with a strong focus on Soapbox.
Since every ActivityPub server implementation has a slightly different interpretation of the protocol, some servers don't quite federate properly with Podium yet. Eventually, we want to make sure that any implementation that can federate nicely with Mastodon should also be able to federate with Podium.
You would like to contribute to Podium? Great! ❤️❤️❤️ Check out the issues page to see if there's anything you intend to jump in on, and read the CONTRIBUTING.md file for guidelines and setting up your dev environment.
Instructions for building Podium from source are in the CONTRIBUTING.md file.
For bugs and feature requests, please check to see if there's already an issue, and if not, open one.
The following libraries and frameworks are used by Podium, with gratitude 💕
- abema/go-mp4; mp4 parsing. MIT License.
- buckket/go-blurhash; used for generating image blurhashes. GPL-3.0 License.
- coreos/go-oidc; OIDC client library. Apache-2.0 License.
- disintegration/imaging; image resizing. MIT License.
- gin-gonic/gin; speedy router engine. MIT License.
- gin-contrib/cors; Gin CORS middleware. MIT License.
- gin-contrib/gzip; Gin gzip middleware. MIT License.
- gin-contrib/sessions; Gin sessions middleware. MIT License.
- gin-contrib/static; Gin static page middleware. MIT License.
- go-fed/httpsig; secure HTTP signature library. BSD-3-Clause License.
- google/uuid; UUID generation. BSD-3-Clause License.
- google/wuffs; png-stripping code. Apache-2.0 License.
- go-playground/validator; struct validation. MIT License.
- gorilla/feeds; RSS + Atom feed generation. BSD-2-Clause License.
- gorilla/websocket; Websocket connectivity. BSD-2-Clause License.
- gruf's libraries:
- gruf/go-debug; debug build tag. MIT License.
- gruf/go-bytesize; byte size parsing / formatting. MIT License.
- gruf/go-cache; object & result caching. MIT License.
- gruf/go-errors; performant multi-error checking MIT License.
- gruf/go-fastcopy; performant pooled I/O copying MIT License.
- gruf/go-kv; log field formatting. MIT License.
- gruf/go-mutexes; safemutex & mutex map. MIT License.
- gruf/go-runners; workerpools and synchronization. MIT License.
- gruf/go-sched; task scheduler. MIT License.
- gruf/go-store; file storage backend (local & s3). MIT License.
- h2non/filetype; filetype checking. MIT License.
- jackc/pgx; Postgres driver. MIT License.
- mcuadros/go-syslog; Syslog server library. MIT License.
- microcosm-cc/bluemonday; HTML user-input sanitization. BSD-3-Clause License.
- miekg/dns; DNS utilities. Go License.
- mitchellh/mapstructure; Go interface => struct parsing. MIT License.
- modernc.org/sqlite; cgo-free port of SQLite. Other License.
- modernc.org/ccgo; c99 AST -> Go translater. BSD-3-Clause License.
- modernc.org/libc; C-runtime services. BSD-3-Clause License.
- mvdan/xurls; URL parsing regular expressions. BSD-3-Clause License.
- oklog/ulid; sequential, database-friendly ID generation. Apache-2.0 License.
- ReneKroon/ttlcache; in-memory caching. MIT License.
- robfig/cron; cron job scheduling. MIT License.
- russross/blackfriday; markdown parsing for statuses. Simplified BSD License.
- spf13/cobra; command-line tooling. Apache-2.0 License.
- spf13/pflag; command-line flag utilities. Apache-2.0 License.
- spf13/viper; configuration management. Apache-2.0 License.
- stretchr/testify; test framework. MIT License.
- superseriousbusiness/exif-terminator; EXIF data removal. GNU AGPL v3 LICENSE.
- superseriousbusiness/activity forked from go-fed/activity; Golang ActivityPub/ActivityStreams library. BSD-3-Clause License.
- superseriousbusiness/oauth2 forked from go-oauth2/oauth2; OAuth server framework and token handling. MIT License.
- go-swagger/go-swagger; Swagger OpenAPI spec generation. Apache-2.0 License.
- tdewolff/minify; HTML minification for Markdown-submitted posts. MIT License.
- uptrace/bun; database ORM. BSD-2-Clause License.
- wagslane/go-password-validator; password strength validation. MIT License.
- ulule/limiter; http rate limit middleware. MIT License.
Sloth logo by Anna Abramek.
The GoToSocial sloth mascot is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.
The Creative Commons Attribution-ShareAlike 4.0 International License license applies specifically to the following files and subdirectories of this repository:
Under the terms of the license, you are free to:
- Share — copy and redistribute the abovementioned material in any medium or format.
- Adapt — remix, transform, and build upon the abovementioned material for any purpose, even commercially.
In alphabetical order (... and order of smell):
- f0x [donate with liberapay]
- kim [check out my code @ codeberg, or find me @ @kim]
- tobi [donate with liberapay]
- maloki [@[email protected]]