v0.19.0 Seditious Sloth 😈

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

• eb72024: [feature] Enforce OAuth token scopes (#3835) (@tsmethurst)
• 4686217: [feature] Added an extra CSS class name to the About This Instance and Register an Account sections in the root index template to allow for easier targeting with custom CSS. (#3843) (@VirtualWolf)
• 0118e03: [feature] Implement CSV import for mutes (#3696) (@xvello)
• b4bb972: [feature/frontend] use localized time string in status & poll info page (#3821) (@cdn0x12)
• e78e817: [feature] add microformat support (#3848) (@AnInternetTroll)
• 1b37944: [feature] Refactor tokens, allow multiple app redirect_uris (#3849) (@tsmethurst)
• 829143d: [feature] Add token review / delete to backend + settings panel (#3845) (@tsmethurst)
• d8113c1: [feature] Parse content warning to HTML, serialize via client API as plaintext (#3876) (@tsmethurst)
• 0c72282: [performance] Optimize local timeline + local status count queries (#3892) (@tsmethurst)
• d3c3d34: [feature/frontend] Add visibility icon for posts (#3908) (@tsmethurst)
• d5847e2: [feature] Application creation + management via API + settings panel (#3906) (@tsmethurst)
• 59aac29: [performance] reindex public timeline + tinker with query a bit (#3918) (@tsmethurst)
• 27171a7: [feature] Parse funkwhale Album as Statusable to allow barebones interacting with bandwagon (#3931) (@tsmethurst)
• b6e481d...

v0.19.0-rc3

Third and hopefully final release candidate for v0.19.0!

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

For instructions to update to this release candidate from versions < v0.19.0-rc1, see the v0.19.0-rc1 release candidate notes, but replace v0.19.0-rc1 with v0.19.0-rc3 throughout.

Release highlights

Compared to rc2:

• Bump some dependency versions.
• Reorder javascript a bit.
• Fix a bug with importing domain permissions.

Migration notes

Upgrading

To upgrade to v0.19.0-rc3 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-rc3 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 v0.19.0-rc1.

Database Migrations

None since v0.19.0-rc1.

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-rc3
Linux	Armv8/ARM64 (64-bit)	🟢 Full	linux_arm64.tar.gz	superseriousbusiness/gotosocial:0.19.0-rc3
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

• eb72024: [feature] Enforce OAuth token scopes (#3835) (@tsmethurst)
• 4686217: [feature] Added an extra CSS class name to the About This Instance and Register an Account sections in the root index template to allow for easier targeting with custom CSS. (#3843) (@VirtualWolf)
• 0118e03: [feature] Implement CSV import for mutes (#3696) (@xvello)
• b4bb972: [feature/frontend] use localized time string in status & poll info page (#3821) (@cdn0x12)
• e78e817: [feature] add microformat support (#3848) (@AnInternetTroll)
• 1b37944: [feature] Refactor tokens, allow multiple app redirect_uris (#3849) (@tsmethurst)
• 829143d: [feature] Add token review / delete to backend + settings panel (#3845) (@tsmethurst)
• d8113c1: [feature] Parse content warning to HTML, serialize via client API as plaintext (#3876) (@tsmethurst)
• 0c72282: [performance] Optimize local timeline + local status count queries (#3892) (@tsmethurst)
• d3c3d34: [feature/frontend] Add visibility icon for posts (#3908) (@tsmethurst)
• d5847e2: [feature] Application creation + management via API + settings panel (#3906) (@tsmethurst)
• 59aac29: [performance] reindex public timeline + tinker with query a bit (#3918) (@tsmethurst)
• 27171a7: [feature] Parse funkwhale Album as Statusable to allow barebones interacting with bandwagon (#3931) (@tsmethurst)
• b6e481d: [feature] Allow user to choose "gallery" style layout for web view of profile (#3917) (@tsmethurst)
• 3949117: [feature] Use blurhashes in frontend, tidy up gallery view a bit (#3948) (@tsmethurst)
• b184432: [feature] Allow editing domain blocks/allows, fix comment import (#3967) (@tsmethurst)
• 650be1e: [feature] Allow deleting avatar + header via settings panel (#3970) (@tsmethurst)
• 365b575: [feature] add TOTP two-factor authentication (2FA) (#3960) (@tsmethurst)
• e032c95: [feature] Implement /oauth/revoke for token revocation (#3983) (@tsmethurst)
• 6ff0d33: [feature/frontend] Add visibility icon for posts (#4005) (@tsmethurst)
• 2fce027: [feature/frontend] Hide "engagement" stats, edits, and other info under a little drop down to unclutter status info bar (#4021) (@tsmethurst)
• a87be80: [feature/frontend] add autocomplete + other helpful attributes to auth html pages (#4029) (@tsmethurst)

Bug fixes

• 24da574: [bugfix] fix refreshed additional media info being ignored (#3867) (@NyaaaWhatsUpDoc)
• ab7ec43: [bugfix] Fix app migration (#3868) (@tsmethurst)
• 69461c4: [bugfix] Return useful err on server start failure (#3879) (@tsmethurst)
• 424f62d: [bugfix] Store and expose status content type (#3870) (@ewwwin)
• 35e94c8: [bugfix] Fix length for type varchar must be at least 1 on Postgres (#3885) (@tsmethurst)
• 0c49d5a: [bugfix] Fix panic when opening instance actor in web view (#3898) (@tsmethurst)
• 657e064: [bugfix] Avoid nil ptr if maintenance router can't be started (#3919) (@tsmethurst)
• cecb1fd: [bugfix] Fix set obfuscate = null error in adoptPerm (#3922) (@tsmethurst)
• 57c5f68: [bugfix] Fix update users query in migration (#3963) (@tsmethurst)
• 6473886: [bugfix] Fix Atkinson Hyperlegible font embedding on Ecks Pee theme. (#3964) (@kvibber)
• e263d23: [bugfix] Change email Date header to use RFC2822 (#3972) (@tsmethurst)
• 6f24205: [bugfix] Don't assume "manuallyApprovesFollowers": true if not set (#3978) (@tsmethurst)
• 19cfa8d: [bugfix] Fix a couple accessibility issues with :focus elements (#3979) (@tsmethurst)
• c8a780e: [bugfix] Fix setting bot on/off (#3986) (@tsmethurst)
• 36758ea: [bugfix] media v2 endpoint fix unset url (#4008) (@Nya...

v0.19.0-rc2

Hello dorks, here's the second release candidate for GoToSocial v0.19.0.

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

For instructions to update to this release candidate from versions < v0.19.0-rc1, see the v0.19.0-rc1 release candidate notes, but replace v0.19.0-rc1 with v0.19.0-rc2 throughout.

Release highlights

Compared to rc1:

• Fixed a couple bugs.
• Frontend tweaks to hide "engagement" stats, edits, and other info under a little drop down to unclutter status info bar.
• Updated list of "ai" user-agents in robots.txt

Migration notes

Upgrading

To upgrade to v0.19.0-rc2 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-rc2 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 v0.19.0-rc1.

Database Migrations

None since v0.19.0-rc1.

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-rc2
Linux	Armv8/ARM64 (64-bit)	🟢 Full	linux_arm64.tar.gz	superseriousbusiness/gotosocial:0.19.0-rc2
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

• eb72024: [feature] Enforce OAuth token scopes (#3835) (@tsmethurst)
• 4686217: [feature] Added an extra CSS class name to the About This Instance and Register an Account sections in the root index template to allow for easier targeting with custom CSS. (#3843) (@VirtualWolf)
• 0118e03: [feature] Implement CSV import for mutes (#3696) (@xvello)
• b4bb972: [feature/frontend] use localized time string in status & poll info page (#3821) (@cdn0x12)
• e78e817: [feature] add microformat support (#3848) (@AnInternetTroll)
• 1b37944: [feature] Refactor tokens, allow multiple app redirect_uris (#3849) (@tsmethurst)
• 829143d: [feature] Add token review / delete to backend + settings panel (#3845) (@tsmethurst)
• d8113c1: [feature] Parse content warning to HTML, serialize via client API as plaintext (#3876) (@tsmethurst)
• 0c72282: [performance] Optimize local timeline + local status count queries (#3892) (@tsmethurst)
• d3c3d34: [feature/frontend] Add visibility icon for posts (#3908) (@tsmethurst)
• d5847e2: [feature] Application creation + management via API + settings panel (#3906) (@tsmethurst)
• 59aac29: [performance] reindex public timeline + tinker with query a bit (#3918) (@tsmethurst)
• 27171a7: [feature] Parse funkwhale Album as Statusable to allow barebones interacting with bandwagon (#3931) (@tsmethurst)
• b6e481d: [feature] Allow user to choose "gallery" style layout for web view of profile (#3917) (@tsmethurst)
• 3949117: [feature] Use blurhashes in frontend, tidy up gallery view a bit (#3948) (@tsmethurst)
• b184432: [feature] Allow editing domain blocks/allows, fix comment import (#3967) (@tsmethurst)
• 650be1e: [feature] Allow deleting avatar + header via settings panel (#3970) (@tsmethurst)
• 365b575: [feature] add TOTP two-factor authentication (2FA) (#3960) (@tsmethurst)
• e032c95: [feature] Implement /oauth/revoke for token revocation (#3983) (@tsmethurst)
• 6ff0d33: [feature/frontend] Add visibility icon for posts (#4005) (@tsmethurst)
• 2fce027: [feature/frontend] Hide "engagement" stats, edits, and other info under a little drop down to unclutter status info bar (#4021) (@tsmethurst)

Bug fixes

• 24da574: [bugfix] fix refreshed additional media info being ignored (#3867) (@NyaaaWhatsUpDoc)
• ab7ec43: [bugfix] Fix app migration (#3868) (@tsmethurst)
• 69461c4: [bugfix] Return useful err on server start failure (#3879) (@tsmethurst)
• 424f62d: [bugfix] Store and expose status content type (#3870) (@ewwwin)
• 35e94c8: [bugfix] Fix length for type varchar must be at least 1 on Postgres (#3885) (@tsmethurst)
• 0c49d5a: [bugfix] Fix panic when opening instance actor in web view (#3898) (@tsmethurst)
• 657e064: [bugfix] Avoid nil ptr if maintenance router can't be started (#3919) (@tsmethurst)
• cecb1fd: [bugfix] Fix set obfuscate = null error in adoptPerm (#3922) (@tsmethurst)
• 57c5f68: [bugfix] Fix update users query in migration (#3963) (@tsmethurst)
• 6473886: [bugfix] Fix Atkinson Hyperlegible font embedding on Ecks Pee theme. (#3964) (@kvibber)
• e263d23: [bugfix] Change email Date header to use RFC2822 (#3972) (@tsmethurst)
• 6f24205: [bugfix] Don't assume "manuallyApprovesFollowers": true if not set (#3978) (@tsmethurst)
• 19cfa8d: [bugfix] Fix a couple accessibility issues with :focus elements (#3979) (@tsmethurst)
• c8a780e: [bugfix] Fix setting bot on/off (#3986) (@tsmethurst)
• 36758ea: [bugfix] media v2 endpoint fix unset url (#4008) (@NyaaaWhatsUpDoc)
• f5ce219...

v0.19.0-rc1

First release candidate for GoToSocial v0.19.0! Woah! Hey now!

Please read the migration notes carefully for instructions on how to upgrade to this version. This version contains several database migrations so you will need to be patient when upgrading, and backup your database first!!

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, and more.

Migration notes

Upgrading

To upgrade to v0.19.0-rc1 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-rc1 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.

Be sure not to interrupt this migration process.

This will take anywhere between a couple seconds and ten minutes or more (on slower hardware).

Please be patient!

⚠️⚠️⚠️

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-rc1
Linux	Armv8/ARM64 (64-bit)	🟢 Full	linux_arm64.tar.gz	superseriousbusiness/gotosocial:0.19.0-rc1
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

• eb72024: [feature] Enforce OAuth token scopes (#3835) (@tsmethurst)
• 4686217: [feature] Added an extra CSS class name to the About This Instance and Register an Account sections in the root index template to allow for easier targeting with custom CSS. (#3843) (@VirtualWolf)
• 0118e03: [feature] Implement CSV import for mutes (#3696) (@xvello)
• b4bb972: [feature/frontend] use localized time string in status & poll info page (#3821) (@cdn0x12)
• e78e817: [feature] add microformat support (#3848) (@AnInternetTroll)
• 1b37944: [feature] Refactor tokens, allow multiple app redirect_uris (#3849) (@tsmethurst)
• 829143d: [feature] Add token review / delete to backend + settings panel (#3845) (@tsmethurst)
• d8113c1: [feature] Parse content warning to HTML, serialize via client API as plaintext (#3876) (@tsmethurst)
• 0c72282: [performance] Optimize local timeline + local status count queries (#3892) (@tsmethurst)
• d3c3d34: [feature/frontend] Add visibility icon for posts (#3908) (@tsmethurst)
• d5847e2: [feature] Application creation + management via API + settings panel (#3906) (@tsmethurst)
• 59aac29: [performance] reindex public timeline + tinker with query a bit (#3918) (@tsmethurst)
• 27171a7: [feature] Parse funkwhale Album as Statusable to allow barebones interacting with bandwagon (#3931) (@tsmethurst)
• b6e481d: [feature] Allow user to choose "gallery" style layout for web view of profile (#3917) (@tsmethurst)
• 3949117: [feature] Use blurhashes in frontend, tidy up gallery view a bit (#3948) (@tsmethurst)
• b184432: [feature] Allow editing domain blocks/allows, fix comment import (#3967) (@tsmethurst)
• 650be1e: [feature] Allow deleting avatar + header via settings panel (#3970) (@tsmethurst)
• 365b575: [feature] add TOTP two-factor authentication (2FA) (#3960) (@tsmethurst)
• e032c95: [feature] Implement /oauth/revoke for token revocation (#3983) (@tsmethurst)
• 6ff0d33: [feature/frontend] Add visibility icon for posts (#4005) (@tsmethurst)

Bug fixes

• 24da574: [bugfix] fix refreshed additional media info being ignored (#3867) (@NyaaaWhatsUpDoc)
• ab7ec43: [bugfix] Fix app migration (#3868) (@tsmethurst)
• 69461c4: [bugfix] Return useful err on server start failure (#3879) (@tsmethurst)
• 424f62d: [bugfix] Store and expos...

v0.18.3 Scroingless Sloth

Hello nerds, another bugfix release :)

This one fixes a bug with domain subscriptions with orphan adoption, which could cause entries for the subscription to not be created. An important bugfix for island networks that rely on allowlist subscription(s) to keep everyone in the network on the same allowlist(s).

Also small wording changes on the frontend, and a fix for an issue that could cause error messages to be swallowed on startup.

If you're updating to this version from v0.18.0, v0.18.1, or v0.18.2, it's a very easy update with no db migrations or config file changes :)

If you're updating to this version from a version before v0.18.0, please follow the update instructions from v0.18.0, but replace 0.18.0 with 0.18.3 throughout. Be aware that the update to 0.18.x contains some very long migrations. Please do read the notes carefully.

Migration notes

Upgrading

To upgrade to v0.18.3 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.18.3 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 v0.18.0.

Database Migrations

None since v0.18.0.

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.18.3
Linux	Armv8/ARM64 (64-bit)	🟢 Full	linux_arm64.tar.gz	superseriousbusiness/gotosocial:0.18.3
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

Bug fixes

• f94da1a: [bugfix] Avoid nil ptr if maintenance router can't be started (#3919) (@tsmethurst)
• b6e56fe: [bugfix] Fix set obfuscate = null error in adoptPerm (#3922) (@tsmethurst)

Chores & version bumps

• 682228f: [chore] Tweak "nothing here!" message (#3907) (@tsmethurst)

v0.18.2 Least Scroingly Sloth

Here's version 0.18.2 of GoToSocial, hopefully the last bugfix release of 0.18.x :)

Mostly bug fixes and version bumps in this one, though it's possible if you were seeing very poor performance on v0.18.0 or v0.18.1 then the small wasm/wazero tweak we made in this release might improve things for you.

If you're updating to this version from v0.18.0 or v0.18.1, it's a very easy update with no db migrations or config file changes :)

If you're updating to this version from a version before v0.18.0, please follow the update instructions from v0.18.0, but replace 0.18.0 with 0.18.2 throughout. Be aware that the update to 0.18.x contains some very long migrations. Please do read the notes carefully.

Migration notes

Upgrading

To upgrade to v0.18.2 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.18.2 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 v0.18.0.

Database Migrations

None since v0.18.0.

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.18.2
Linux	Armv8/ARM64 (64-bit)	🟢 Full	linux_arm64.tar.gz	superseriousbusiness/gotosocial:0.18.2
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

Bug fixes

• f5967d0: [bugfix] fix refreshed additional media info being ignored (#3867) (@NyaaaWhatsUpDoc)
• d0ae8f6: [bugfix] Return useful err on server start failure (#3879) (@tsmethurst)
• edfbbff: [bugfix] Fix length for type varchar must be at least 1 on Postgres (#3885) (@tsmethurst)
• 8beeeb9: [bugfix] Fix panic when opening instance actor in web view (#3898) (@tsmethurst)

Chores & version bumps

• a372ee9: [chore] Fix typo in common.tsx (#3834) (@PrivacyDragon)
• d8c027f: [chore]: Bump github.com/tetratelabs/wazero from 1.8.2 to 1.9.0 (#3827) (@dependabot[bot])
• f1af6a5: [chore]: Bump github.com/google/go-cmp from 0.6.0 to 0.7.0 (#3826) (@dependabot[bot])
• a935993: [chore]: Bump golang.org/x/crypto from 0.33.0 to 0.34.0 (#3824) (@dependabot[bot])
• 6631c82: [chore] Update KimMachineGun/automemlimit (#3841) (@tsmethurst)
• 12e3f4c: [chore] Remove duplicate swagger docs build in Dockerfile (#3842) (@tsmethurst)
• 4819a33: [chore]: Bump github.com/go-jose/go-jose/v4 from 4.0.2 to 4.0.5 (#3831) (@dependabot[bot])
• 97adf00: [chore]: Bump github.com/ncruces/go-sqlite3 from 0.23.0 to 0.24.0 (#3862) (@dependabot[bot])
• 310319d: [chore] fixed email template to align with the new "Log in" button + separate page (#3871) (@wolfyjade)
• 10ad4b2: [chore] update links in CONTRIBUTING.md (#3881) (@cdn0x12)
• 0a8d218: [chore]: Bump golang.org/x/crypto from 0.35.0 to 0.36.0 (#3887) (@dependabot[bot])
• d0cbd54: [chore] add warning message when wazero compiler not supported (#3894) (@NyaaaWhatsUpDoc)
• 602d235: [chore] vendoring (@tsmethurst)
• 12d4d36: bumps our uptrace/bun dependencies to v1.2.10 (#3865) (@NyaaaWhatsUpDoc)
• 3cc2b93: bumps go-ffmpreg to v0.6.6 (#3866) (@NyaaaWhatsUpDoc)
• 120be69: bumps our uptrace/bun dependencies to v1.2.11 (#3895) (@NyaaaWhatsUpDoc)

Documentation

• f7ac15f: [docs] correct docker version format (#3832) (@elliotblackburn)
• 2decea6: [docs] Fix swagger operation descriptions (#3830) (@mkljczk)
• e6b4426: [docs] Update swagger docs command (#3897) (@tsmethurst)
• bc6b7c3: Document importing posts (#3844) (@VyrCossont)

v0.18.1 Less Scroingly Sloth

Hiya! Here's a bugfix release of GoToSocial!

We added ETag cache control handling to robots.txt, to make it easier for crawlers to be able to tell which instances they should and shouldn't index.

If you're updating to this version from v0.18.0, it's a very easy update with no db migrations or config file changes :)

If you're updating to this version from a version before v0.18.0, please follow the update instructions from v0.18.0, but replace 0.18.0 with 0.18.1 throughout. Be aware that the update to 0.18.x contains some very long migrations. Please do read the notes carefully.

Migration notes

Upgrading

To upgrade to v0.18.1 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.18.1 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 v0.18.0.

Database Migrations

None since v0.18.0.

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.18.1
Linux	Armv8/ARM64 (64-bit)	🟢 Full	linux_arm64.tar.gz	superseriousbusiness/gotosocial:0.18.1
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

• fd670c6: [feature] Use ETag for robots.txt to prevent mishaps (#3829) (@tsmethurst)

v0.18.0 Scroingly Sloth

Here's GoToSocial v0.18.0 Scroingly Sloth!

Please read the migration notes carefully for instructions on how to upgrade to this version. This version contains several very long migrations so you will need to be patient when upgrading, and backup your database first!!

Release highlights

• Status edit support: one of our most-requested features! You can now edit your own statuses, and see instance edit history from other accounts too (if your instance has them stored).
• Push notifications: probably the second most-requested feature! GoToSocial can now send push notifications to clients via their configured push providers.
  You may need to uninstall / reinstall client applications, or log out and back in again, for this feature to work. (And if you're using Tusky, make sure you've got ntfy installed).
• Global instance css customization: admins can now apply custom CSS across their entire instance via the settings panel.
• Domain permission subscriptions: it's now possible to configure your instance to subscribe to CSV, JSON, or plaintext lists of domain permissions.
  Each night, your instance will fetch and automatically create domain permissions (or permission drafts) based on what it finds in a subscribed list.
  See the domain permission subscription documentation for more information.
• Trusted-proxies helper: instances with improperly configured trusted-proxies settings will now show a warning on the homepage, so admins can make sure their instance is configured correctly. Check your own instance homepage after updating to see if you need to do anything.
• Better outbox sorting: messages from GoToSocial are now delivered more quickly to people you mention, so conversations across instances should feel a bit snappier.
• Log in button: there's now a login button in the top right of the instance homepage, which leads to a helpful page about clients, with a link to the settings panel. Should make things less confusing for new users!
• Granular stats controls: with the instance-stats-mode setting, admins can now choose if and how their instance serves stats via the nodeinfo endpoints. Existing behavior from v0.17.0 is the default.
• Post backdating: via the API you can now backdate posts (if enabled in config.yaml). This is our first step towards making it possible to import your post history from elsewhere into your GoToSocial instance. While there's no way to do this in the settings panel yet, you can already use third-party tools like Slurp to import posts from a Mastodon export (see Slurp).
• Configurable sign-up limits: you can now configure your sign-up backlog length and sign-up throttling (defaults remain the same).
• NetBSD and FreeBSD builds: yep!
• Respect users prefers-color-scheme preference: there's now a light mode default theme to complement our trusty dark mode theme, and the theme will switch based on a visitor's prefers-color-scheme configuration. This applies to all page and profiles, with the exception of some custom themes. Works in the settings panel too!

Migration notes

Upgrading

To upgrade to v0.18.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.18.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

The configuration file has changed since the previous release.

• Add instance-subscriptions-process-from (default "23:00").
• Add instance-subscriptions-process-every (default "24h").
• Add instance-stats-mode (default "" ie., existing v0.17.0 behavior).
• Add instance-allow-backdating-statuses (default true).
• Add accounts-registration-daily-limit (default 10 ie., existing v0.17.0 behavior).
• Add accounts-registration-backlog-limit (default 20 ie., existing v0.17.0 behavior).

You can see a diff of the config file here: v0.17.4...v0.18.0#diff-c071e03510b2c57e193a44503fd9528a785f0f411497cc75841a9f8d0b1ac622

Database Migrations

⚠️⚠️⚠️

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

Be sure not to interrupt this migration process.

This will take anywhere between a minute and maybe an hour or even more (on slower hardware / with bigger database size).

If running with sqlite, you will need to ensure you have sufficient free space for the transaction / wal file to grow while running migrations. Aim to have about 80% of your db size free. For example, if your sqlite.db file is 10GiB, you should try to have at least 8GiB of free space before triggering the update. After the migration the wal file will be flushed again (do not do this manually, let sqlite do it).

Please be patient!

⚠️⚠️⚠️

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.18.0
Linux	Armv8/ARM64 (64-bit)	🟢 Full	linux_arm64.tar.gz	superseriousbusiness/gotosocial:0.18.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

• e3c2b79: [performance] minimise log field allocations (#3529) (@NyaaaWhatsUpDoc)
• c2029df: [feature] Allow emoji shortcode to be 1-character length (#3556) (@tsmethurst)
• 3015436: [feature] Add domain permission drafts and excludes (#3547) (@tsmethurst)
• cac9d65: [performance] convert enum strings to ints (#3558) (@NyaaaWhatsUpDoc)
• c9d36f7: [performance] use new instance of bun.DB after migrations to reduce number of in-memory model schema (#3578) (@NyaaaWhatsUpDoc)
• dce85a2: [feature/themes] Add auto-switching ...

v0.18.0-rc3

Here's the third (hopefully final?) release candidate for GoToSocial v0.18.0.

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

For instructions to update to this release candidate from versions < v0.18.0-rc1, see the v0.18.0-rc1 release candidate notes, but replace v0.18.0-rc1 with v0.18.0-rc3 throughout.

Release highlights

Compared to rc2:

• Fixed a couple bugs
• Batched migrations so they should run smoother and give more feedback to users
• Adding forward-compatibility code for future Approval objects

Migration notes

Upgrading

To upgrade to v0.18.0-rc3 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.18.0-rc3 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 v0.18.0-rc2.

Database Migrations

None since v0.18.0-rc2.

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.18.0-rc3
Linux	Armv8/ARM64 (64-bit)	🟢 Full	linux_arm64.tar.gz	superseriousbusiness/gotosocial:0.18.0-rc3
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

• e3c2b79: [performance] minimise log field allocations (#3529) (@NyaaaWhatsUpDoc)
• c2029df: [feature] Allow emoji shortcode to be 1-character length (#3556) (@tsmethurst)
• 3015436: [feature] Add domain permission drafts and excludes (#3547) (@tsmethurst)
• cac9d65: [performance] convert enum strings to ints (#3558) (@NyaaaWhatsUpDoc)
• c9d36f7: [performance] use new instance of bun.DB after migrations to reduce number of in-memory model schema (#3578) (@NyaaaWhatsUpDoc)
• dce85a2: [feature/themes] Add auto-switching themes for blurple/brutalist/solarized (#3588) ( <>)
• 9609c45: [feature] Add global instance CSS customization setting (#3352) (@S0yKaf)
• 3e18d97: [feature] unending polls (#3592) (@NyaaaWhatsUpDoc)
• 23fc70f: [feature] add support for receiving federated status edits (#3597) (@NyaaaWhatsUpDoc)
• 9477fd7: [feature] Allow partial-word hashtags using non-breaking spaces (#3606) (@tsmethurst)
• fe8d5f2: [feature] add support for clients editing statuses and fetching status revision history (#3628) (@NyaaaWhatsUpDoc)
• e9bb7dd: [feature] Create/update/remove domain permission subscriptions (#3623) (@tsmethurst)
• 451803b: [feature] Fetch + create domain permissions from subscriptions nightly (#3635) (@tsmethurst)
• 0a99901: [performance] reduce InboxForward->Create calls by partially implementing Exists() (#3647) (@NyaaaWhatsUpDoc)
• 1472d92: [feature] Add published property to outgoing AP Actor representations (#3671) (@tsmethurst)
• b42cb7a: [feature] Add warning about trusted-proxies to make config easier (#3675) (@tsmethurst)
• 9333bbc: [feature] Serve bot accounts over AP as Service instead of Person (#3672) (@tsmethurst)
• 5b765d7: [feature] Push notifications (#3587) (@VyrCossont)
• 3720251: [feature] show status edits on frontend (#3678) (@NyaaaWhatsUpDoc)
• 71b5035: [feature] Process incoming Undo Announce properly (#3676) (@tsmethurst)
• 7b7fc52: [feature/frontend] Add login button to index page which reiterates info about clients (#3377) (@vivlim)
• 65fb8ab: [feature] Implement deliveryRecipientPreSort to prioritize delivery to mentioned accounts (#3668) (@tsmethurst)
• d16e4fa: [feature] Use maintenance router to serve 503 while server is starting/migrating (#3705) (@tsmethurst)
• ab758cc: [feature] Add system message wrappers for pending replies and placeholder attachments (#3713) (@VyrCossont)
• a55bd6d: [feature] Add instance-stats-randomize config option (#3718) (@tsmethurst)
• 27844b7: [feature] Implement Web Push notification policy (#3721) (@VyrCossont)
• 07d2770: [feature] Change instance-stats-randomize to instance-stats-mode with multiple options; implement nodeinfo 2.1 (#3734) (@tsmethurst)
• baed591: [feature] Use X-Robots-Tag headers to instruct scrapers/crawlers (#3737) (@tsmethurst)
• 42bbbaa: [feature/frontend] add light mode color scheme of base css, adapt to prefers-color-scheme (#3765) (@cdn0x12)
• 787bdc1: [feature] make account sign-up / backlog limits configurable (#3768) (@tsmethurst)
• 37dbf31: [performance] improved enum migrations (#3782) (@NyaaaWhatsUpDoc)
• fccb0bc: [feature] Implement backfilling statuses thru scheduled_at (#3685) (@VyrCossont)
• 96716e4: [feature] Forward-compatibility with Approval objects (#3807) (@tsmethurst)
• 8829ee1: [feature] Add page-specific class per template (#3814) (@tsmethurst)

Bug fixes

• 9ace025: [bugfix] post counters should not include direct messages (#3554) (@Booklordofthedings)
• a444ade: [bugfix] notification types missing from link ...

v0.18.0-rc2

Here's version 0.18.0-rc2 of GoToSocial.

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

For instructions to update to this release candidate from versions < v0.18.0-rc1, see the v0.18.0-rc1 release candidate notes, but replace v0.18.0-rc1 with v0.18.0-rc2 throughout.

Migration notes

Upgrading

To upgrade to v0.18.0-rc2 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.18.0-rc2 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

The configuration file has changed since the previous release candidate.

• Added instance-allow-backdating-statuses.
• Added accounts-registration-daily-limit.
• Added accounts-registration-backlog-limit.

You can see a diff of the config file here: v0.18.0-rc1...v0.18.0-rc2#diff-c071e03510b2c57e193a44503fd9528a785f0f411497cc75841a9f8d0b1ac622

Database Migrations

No new migrations since v0.18.0-rc1.

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.18.0-rc2
Linux	Armv8/ARM64 (64-bit)	🟢 Full	linux_arm64.tar.gz	superseriousbusiness/gotosocial:0.18.0-rc2
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

• e3c2b79: [performance] minimise log field allocations (#3529) (@NyaaaWhatsUpDoc)
• c2029df: [feature] Allow emoji shortcode to be 1-character length (#3556) (@tsmethurst)
• 3015436: [feature] Add domain permission drafts and excludes (#3547) (@tsmethurst)
• cac9d65: [performance] convert enum strings to ints (#3558) (@NyaaaWhatsUpDoc)
• c9d36f7: [performance] use new instance of bun.DB after migrations to reduce number of in-memory model schema (#3578) (@NyaaaWhatsUpDoc)
• dce85a2: [feature/themes] Add auto-switching themes for blurple/brutalist/solarized (#3588) ( <>)
• 9609c45: [feature] Add global instance CSS customization setting (#3352) (@S0yKaf)
• 3e18d97: [feature] unending polls (#3592) (@NyaaaWhatsUpDoc)
• 23fc70f: [feature] add support for receiving federated status edits (#3597) (@NyaaaWhatsUpDoc)
• 9477fd7: [feature] Allow partial-word hashtags using non-breaking spaces (#3606) (@tsmethurst)
• fe8d5f2: [feature] add support for clients editing statuses and fetching status revision history (#3628) (@NyaaaWhatsUpDoc)
• e9bb7dd: [feature] Create/update/remove domain permission subscriptions (#3623) (@tsmethurst)
• 451803b: [feature] Fetch + create domain permissions from subscriptions nightly (#3635) (@tsmethurst)
• 0a99901: [performance] reduce InboxForward->Create calls by partially implementing Exists() (#3647) (@NyaaaWhatsUpDoc)
• 1472d92: [feature] Add published property to outgoing AP Actor representations (#3671) (@tsmethurst)
• b42cb7a: [feature] Add warning about trusted-proxies to make config easier (#3675) (@tsmethurst)
• 9333bbc: [feature] Serve bot accounts over AP as Service instead of Person (#3672) (@tsmethurst)
• 5b765d7: [feature] Push notifications (#3587) (@VyrCossont)
• 3720251: [feature] show status edits on frontend (#3678) (@NyaaaWhatsUpDoc)
• 71b5035: [feature] Process incoming Undo Announce properly (#3676) (@tsmethurst)
• 7b7fc52: [feature/frontend] Add login button to index page which reiterates info about clients (#3377) (@vivlim)
• 65fb8ab: [feature] Implement deliveryRecipientPreSort to prioritize delivery to mentioned accounts (#3668) (@tsmethurst)
• d16e4fa: [feature] Use maintenance router to serve 503 while server is starting/migrating (#3705) (@tsmethurst)
• ab758cc: [feature] Add system message wrappers for pending replies and placeholder attachments (#3713) (@VyrCossont)
• a55bd6d: [feature] Add instance-stats-randomize config option (#3718) (@tsmethurst)
• 27844b7: [feature] Implement Web Push notification policy (#3721) (@VyrCossont)
• 07d2770: [feature] Change instance-stats-randomize to instance-stats-mode with multiple options; implement nodeinfo 2.1 (#3734) (@tsmethurst)
• baed591: [feature] Use X-Robots-Tag headers to instruct scrapers/crawlers (#3737) (@tsmethurst)
• 42bbbaa: [feature/frontend] add light mode color scheme of base css, adapt to prefers-color-scheme (#3765) (@cdn0x12)
• 787bdc1: [feature] make account sign-up / backlog limits configurable (#3768) (@tsmethurst)
• 37dbf31: [performance] improved enum migrations (#3782) (@NyaaaWhatsUpDoc)
• fccb0bc: [feature] Implement backfilling statuses thru scheduled_at (#3685) (@VyrCossont)

Bug fixes

• 9ace025: [bugfix] post counters should not include direct messages (#3554) (@Booklordofthedings)
• a444ade: [bugfix] notification types missing from link header (#3571) (@NyaaaWhatsUpDoc)
• 6a8af42: [bugfix] ...