github superseriousbusiness/gotosocial v0.19.0
v0.19.0 Seditious Sloth 😈
on GitHub

latest releases: v0.20.0, v0.20.0-rc4, v0.20.0-rc2...
8 months ago

What's that coming over the hill, is it a monster? Is it a monster?

Yes, it's version 0.19.0 of GoToSocial, aka Seditious Sloth 😈!

Please read the migration notes carefully for instructions on how to upgrade to this version.

The update contains several database migrations, so please check the database migration section closely, and make sure you've backed up your database before updating, so that you can restore from backup if something goes wrong!

Release highlights

  • OAuth token scope enforcement: Token scopes (read, write etc) now actually do stuff! So we removed the big "scopes don't do stuff!" warning in the docs. The enforced scopes match the Mastodon API token scopes, so there shouldn't be any surprises for bot owners / app developers.
    See https://docs.gotosocial.org/en/latest/api/swagger/ for more info.
  • Token review / invalidation: You can now review and invalidate tokens issued for your account in the settings panel, to help keep your account secure.
    Docs: https://docs.gotosocial.org/en/latest/user_guide/settings/#access-tokens
  • Create and manage applications in the settings panel: Handy for people who want to run bots and applications with GoToSocial!
    Docs: https://docs.gotosocial.org/en/latest/user_guide/settings/#applications
  • Gallery-style profile layout option: You can now choose to lay out the web view of your profile in a 'gram style gallery. Good for people who mostly post media and want to put that at the forefront.
    Docs: https://docs.gotosocial.org/en/latest/user_guide/settings/#select-layout
  • Support for two-factor authentication (aka 2FA): If your instance isn't configured to use an OIDC provider, you can now secure your account with 2FA via a QR code and an authenticator app. When logging in with 2FA enabled, you will have to provide a time-based one-time password. Security!
    Docs: https://docs.gotosocial.org/en/latest/user_guide/settings/#two-factor-authentication
  • Lots of web view tweaks including nicer media rendering on chrome, proper blurhash support, much better support for keyboard-based page navigation, wider font support for different scripts, tidier status info bar, and more.
  • OAuth bugfixes should allow more flexibility and compatibility when logging in with or authorizing third-party applications.
  • **bandwagon.fm compatibility fixes: you can now follow Bandwagon.fm artists from your GoToSocial account and receive posts / announcements from them.
  • Edit domain permissions: you can now edit the obfuscate and public and private comment fields in domain permissions (blocks/allows) instead of having to remove and recreate the permission to update the comments.

Migration notes

Upgrading

To upgrade to v0.19.0 from a previous release:

Binary/tar

  1. Stop GoToSocial.
  2. Back up your database! If you're running on SQLite, this is as simple as copying your sqlite.db file, eg., cp sqlite.db sqlite.db.backup.
  3. Download and untar the new release, including the web assets and html templates.
  4. Edit your config.yaml file if necessary (see below).
  5. Start GoToSocial.
  6. Wait patiently for any migrations to run, do not interrupt migrations or you could leave your db in a broken state and will have to restore from backup!
  7. Enjoy your updated instance.

Docker

  1. Stop GoToSocial.
  2. Back up your database! If you're running on SQLite, this is as simple as copying your sqlite.db file, eg., cp sqlite.db sqlite.db.backup.
  3. Pull the new docker container (superseriousbusiness/gotosocial:0.19.0 or superseriousbusiness/gotosocial:latest)
  4. Edit your config.yaml file or environment variables if necessary (see below).
  5. Start GoToSocial.
  6. Wait patiently for any migrations to run, do not interrupt migrations or you could leave your db in a broken state and will have to restore from backup!
  7. Enjoy your updated instance.

config.yaml

No changes since 0.18.3.

Database Migrations

⚠️⚠️⚠️

This release contains database migrations which will run the first time you start up this new version.

Before running the update and its migrations, try to ensure you have disk space remaining equal to 1x your current database size, for safety. Eg., if you have a 10gb database file, you should aim to have 10gb of disk space still available. This is because the migrations need to copy and modify the entire accounts table, which occupies a decent chunk of database space.

Be sure not to interrupt this migration process.

This will take anywhere between a couple seconds and ten minutes or more (on slower hardware). You can follow the migration process in the GoToSocial logs.

Please be patient!

⚠️⚠️⚠️

Settings panel

Because of updates to the way the settings panel stores its OAuth access tokens, after updating you will be logged out of your GtS settings panel and will have to log in again.

Which release archive/container should I use?

GoToSocial releases binary builds for 64-bit Linux, FreeBSD, and NetBSD operating systems. We also release Docker builds for 64-bit Linux.

OS Architecture Support level Binary archive Docker
Linux x86-64/AMD64 (64-bit) 🟢 Full linux_amd64.tar.gz superseriousbusiness/gotosocial:0.19.0
Linux Armv8/ARM64 (64-bit) 🟢 Full linux_arm64.tar.gz superseriousbusiness/gotosocial:0.19.0
FreeBSD x86-64/AMD64 (64-bit) 🟢 Full freebsd_amd64.tar.gz Not provided
FreeBSD Armv8/ARM64 (64-bit) 🟢 Full freebsd_arm64.tar.gz Not provided
NetBSD x86-64/AMD64 (64-bit) 🟢 Full netbsd_amd64.tar.gz Not provided
NetBSD Armv8/ARM64 (64-bit) 🟢 Full netbsd_arm64.tar.gz Not provided

nowasm

For your convenience, we also provide UNSUPPORTED, EXPERIMENTAL BUILDS, created using the nowasm tag, in the downloads list below. There is no Docker build for nowasm.

GoToSocial releases built with nowasm use the Go-native, modernc version of SQLite instead of the WASM one, and will use on-system ffmpeg and ffprobe binaries for media processing.

Using a nowasm build is currently the only way to run GoToSocial on a 32-bit system.

For more information on running a nowasm build, see the nowasm documentation page.

Changelog

Features and performance

Bug fixes

Chores & version bumps

Documentation

Other

Check out latest releases or
releases around superseriousbusiness/gotosocial v0.19.0

Don't miss a new gotosocial release

NewReleases is sending notifications on new releases.

Get notifications