Releases: superseriousbusiness/gotosocial
v0.18.0-rc1
Here's the first release candidate of GoToSocial v0.18.0!
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.
- Better outbox sorting: messages from GoToSocial are now delivered more quickly to people you mention, so conversations across instances should feel 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.
Migration notes
Upgrading
To upgrade to v0.18.0-rc1 from a previous release:
Binary/tar
- Stop GoToSocial.
- 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
. - Download and untar the new release, including the web assets and html templates.
- Edit your config.yaml file if necessary (see below).
- Start GoToSocial.
- 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!
- Enjoy your updated instance.
Docker
- Stop GoToSocial.
- 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
. - Pull the new docker container (
superseriousbusiness/gotosocial:0.18.0-rc1
orsuperseriousbusiness/gotosocial:latest
) - Edit your config.yaml file or environment variables if necessary (see below).
- Start GoToSocial.
- 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!
- Enjoy your updated instance.
config.yaml
The configuration file has changed since the previous release.
- Added
instance-subscriptions-process-from
. - Added
instance-subscriptions-process-every
. - Added
instance-stats-mode
.
You can see a diff of the config file here: v0.17.3...v0.18.0-rc1#diff-c071e03510b2c57e193a44503fd9528a785f0f411497cc75841a9f8d0b1ac622
Database Migrations
This release may contain 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 up to an hour 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.18.0-rc1 |
Linux | Armv8/ARM64 (64-bit) | 🟢 Full | linux_arm64.tar.gz | superseriousbusiness/gotosocial:0.18.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
- 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 (#...
v0.17.3 Most Selective Sloth
Hello hello, hopefully the final bugfix of the 0.17.x release while we get on with 0.18.0 :)
There was a bug in 0.17.2 where some Java-based clients didn't like some of the large numbers used in the /api/v1/instance
and /api/v2/instance
responses, so we made them smaller. That's it!
If updating to this version from 0.16.0 or below, please follow the instructions for v0.17.0, replacing 0.17.0
with 0.17.3
throughout.
If updating to this version from 0.17.x, follow the instructions below.
Migration notes
Upgrading
To upgrade to v0.17.3 from a previous release:
Binary/tar
- Stop GoToSocial.
- 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
. - Download and untar the new release, including the web assets and html templates.
- Edit your config.yaml file if necessary (see below).
- Start GoToSocial.
- 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!
- Enjoy your updated instance.
Docker
- Stop GoToSocial.
- 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
. - Pull the new docker container (
superseriousbusiness/gotosocial:0.17.3
orsuperseriousbusiness/gotosocial:latest
) - Edit your config.yaml file or environment variables if necessary (see below).
- Start GoToSocial.
- 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!
- Enjoy your updated instance.
config.yaml
No changes since 0.17.2.
Database Migrations
This release may contain 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?
Tl;dr: Regardless of whether you're using SQLite or Postgres as your DB driver, you most likely you want the regular version without moderncsqlite
in the name.
However, if you're on FreeBSD, 32-bit Linux or 32-bit ARM, we recommend using the moderncsqlite
version instead.
You may need to change some configuration options too. See the table below:
OS | Architecture | Support level | Binary archive | Docker |
---|---|---|---|---|
Linux | x86-64/AMD64 (64-bit) | 🟢 Full | linux_amd64.tar.gz | superseriousbusiness/gotosocial:0.17.3 |
Linux | Armv8/ARM64 (64-bit) | 🟢 Full | linux_arm64.tar.gz | superseriousbusiness/gotosocial:0.17.3 |
FreeBSD | x86-64/AMD64 (64-bit) | 🟢 Full1 | freebsd_amd64_moderncsqlite.tar.gz | None provided |
Linux | x86-32/i386 (32-bit) | 🟡 Partial2 | linux_386_moderncsqlite.tar.gz | superseriousbusiness/gotosocial:0.17.3-moderncsqlite |
Linux | Armv7/ARM32 (32-bit) | 🟡 Partial2 | linux_armv7_moderncsqlite.tar.gz | superseriousbusiness/gotosocial:0.17.3-moderncsqlite |
Linux | Armv6/ARM32 (32-bit) | 🟡 Partial2 | linux_armv6_moderncsqlite.tar.gz | superseriousbusiness/gotosocial:0.17.3-moderncsqlite |
FreeBSD
moderncsqlite
version currently recommended, though you might have success with the regular WASM SQLite version.
If running with regular WASM SQLite and having instability or memory issues, the following settings may help:
db-max-open-conns-multiplier: 0
db-sqlite-journal-mode: "TRUNCATE"
db-sqlite-synchronous: "FULL"
32-bit
moderncsqlite
version is needed, as performance with regular WASM SQLite is not guaranteed when running on 32-bit.
Remote media processing will likely not work with reasonable performance, so you should set the following config variables to prevent download of remote media onto your instance:
media-remote-max-size: 0
media-emoji-remote-max-size: 0
Changelog
Bug fixes
- 6f4cb2f: [bugfix] sets the max value placeholders to MaxInt32 instead of MaxInt (#3517) (@NyaaaWhatsUpDoc)
Chores & version bumps
- e855a02: [chore] update docs assets path (#3514) (@tsmethurst)
Documentation
v0.17.2 Ridiculously Selective Sloth
Here's bugfix version 0.17.2 of GoToSocial!
If updating to this version from 0.16.0 or below, please follow the instructions for v0.17.0, replacing 0.17.0
with 0.17.2
throughout.
If updating to this version from 0.17.1, or 0.17.0, follow the instructions below.
Release highlights
- Small filter bugfixes.
- Some small tweaks to /api/v1/instance and /api/v2/instance
- Better support for soundless webm files
Migration notes
Upgrading
To upgrade to v0.17.2 from a previous release:
Binary/tar
- Stop GoToSocial.
- 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
. - Download and untar the new release, including the web assets and html templates.
- Edit your config.yaml file if necessary (see below).
- Start GoToSocial.
- 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!
- Enjoy your updated instance.
Docker
- Stop GoToSocial.
- 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
. - Pull the new docker container (
superseriousbusiness/gotosocial:0.17.2
orsuperseriousbusiness/gotosocial:latest
) - Edit your config.yaml file or environment variables if necessary (see below).
- Start GoToSocial.
- 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!
- Enjoy your updated instance.
config.yaml
The configuration file has changed since the previous release.
- Add
media-image-size-hint
with a default of 5MiB. - Add
media-video-size-hint
with a default of 40MiB.
You can see a diff of the config file here: v0.17.1...v0.17.2#diff-c071e03510b2c57e193a44503fd9528a785f0f411497cc75841a9f8d0b1ac622
Database Migrations
This release may contain 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?
Tl;dr: Regardless of whether you're using SQLite or Postgres as your DB driver, you most likely you want the regular version without moderncsqlite
in the name.
However, if you're on FreeBSD, 32-bit Linux or 32-bit ARM, we recommend using the moderncsqlite
version instead.
You may need to change some configuration options too. See the table below:
OS | Architecture | Support level | Binary archive | Docker |
---|---|---|---|---|
Linux | x86-64/AMD64 (64-bit) | 🟢 Full | linux_amd64.tar.gz | superseriousbusiness/gotosocial:0.17.2 |
Linux | Armv8/ARM64 (64-bit) | 🟢 Full | linux_arm64.tar.gz | superseriousbusiness/gotosocial:0.17.2 |
FreeBSD | x86-64/AMD64 (64-bit) | 🟢 Full1 | freebsd_amd64_moderncsqlite.tar.gz | None provided |
Linux | x86-32/i386 (32-bit) | 🟡 Partial2 | linux_386_moderncsqlite.tar.gz | superseriousbusiness/gotosocial:0.17.2-moderncsqlite |
Linux | Armv7/ARM32 (32-bit) | 🟡 Partial2 | linux_armv7_moderncsqlite.tar.gz | superseriousbusiness/gotosocial:0.17.2-moderncsqlite |
Linux | Armv6/ARM32 (32-bit) | 🟡 Partial2 | linux_armv6_moderncsqlite.tar.gz | superseriousbusiness/gotosocial:0.17.2-moderncsqlite |
FreeBSD
moderncsqlite
version currently recommended, though you might have success with the regular WASM SQLite version.
If running with regular WASM SQLite and having instability or memory issues, the following settings may help:
db-max-open-conns-multiplier: 0
db-sqlite-journal-mode: "TRUNCATE"
db-sqlite-synchronous: "FULL"
32-bit
moderncsqlite
version is needed, as performance with regular WASM SQLite is not guaranteed when running on 32-bit.
Remote media processing will likely not work with reasonable performance, so you should set the following config variables to prevent download of remote media onto your instance:
media-remote-max-size: 0
media-emoji-remote-max-size: 0
Changelog
Features and performance
- f3b2eca: [feature] add support for hinting via api/v_/instance preferred image / video max sizes (#3505) (@NyaaaWhatsUpDoc)
Bug fixes
- d8a8386: [bugfix] incorrect /api/v_/instance domain uri fields (#3477) (@NyaaaWhatsUpDoc)
- 7ec6509: [bugfix] support classifying correct video codec without audio as webm (#3494) (@NyaaaWhatsUpDoc)
- 8f288f1: [bugfix] determine mime-type to use during ffprobe evaluation stage, don't bother checking against file extension (#3506) (@NyaaaWhatsUpDoc)
- e953d80: [bugfix] Fix setting immediate
expires_at
value on filter endpoints (#3513) (@tsmethurst)
Chores & version bumps
- 8f4a96c: [chore]: Bump github.com/tdewolff/minify/v2 from 2.21.0 to 2.21.1 (#3489) (@dependabot[bot])
- e86592b: [chore] pull in go-ffmpreg v0.4.1 (#3485) (@NyaaaWhatsUpDoc)
- 1954ccb: [chore]: Bump github.com/minio/minio-go/v7 from 7.0.78 to 7.0.79 (#3488) (@dependabot[bot])
- c8647f7: [chore] Bump http-proxy-middleware from 2.0.6 to 2.0.7 in /web/source (#3481) (@dependabot[bot])
- 3b037d1: [chore] Bump elliptic from 6.5.7 to 6.6.0 in /web/source (#3495) (@dependabot[bot])
- 49eb8f6: [chore] Fix minor typo in About template (#3502) (@fl4nn)
- d2820a1: [chore]: Bump github.com/minio/minio-go/v7 from 7.0.79 to 7.0.80 (#3511) (@dependabot[bot])
- 51cb6ca: update go-sqlite3 => v0.20.0 (#3483) (@NyaaaWhatsUpDoc)
- 53aaeb1: previously we were using the ffmpeg runner for ffprobe 🤦 (#3512) (@NyaaaWhatsUpDoc)
Documentation
v0.17.1 Very Selective Sloth
Here's bugfix version 0.17.1 of GoToSocial!
If updating to this version from 0.16.0 or below, please follow the instructions for v0.17.0, replacing 0.17.0
with 0.17.1
throughout.
If updating to this version from 0.17.0, follow the instructions below.
Release highlights
- Fixed a streaming bug which may have been causing issues with some clients like Elk and Ice Cubes.
- Add alt-text/descriptions for default avatar + header images.
Migration notes
Upgrading
To upgrade to v0.17.1 from a previous release:
Binary/tar
- Stop GoToSocial.
- 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
. - Download and untar the new release, including the web assets and html templates.
- Edit your config.yaml file if necessary (see below).
- Start GoToSocial.
- 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!
- Enjoy your updated instance.
Docker
- Stop GoToSocial.
- 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
. - Pull the new docker container (
superseriousbusiness/gotosocial:0.17.1
orsuperseriousbusiness/gotosocial:latest
) - Edit your config.yaml file or environment variables if necessary (see below).
- Start GoToSocial.
- 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!
- Enjoy your updated instance.
config.yaml
No changes compared to 0.17.0.
Database Migrations
This release contains one database migration which will run the first time you start up this new version.
Be sure not to interrupt this migration process.
This will probably take only a couple of seconds, though if you're on SQLite, the ANALYZE that's run afterwards may take a bit of time.
Which release archive/container should I use?
Tl;dr: Regardless of whether you're using SQLite or Postgres as your DB driver, you most likely you want the regular version without moderncsqlite
in the name.
However, if you're on FreeBSD, 32-bit Linux or 32-bit ARM, we recommend using the moderncsqlite
version instead.
You may need to change some configuration options too. See the table below:
OS | Architecture | Support level | Binary archive | Docker |
---|---|---|---|---|
Linux | x86-64/AMD64 (64-bit) | 🟢 Full | linux_amd64.tar.gz | superseriousbusiness/gotosocial:0.17.1 |
Linux | Armv8/ARM64 (64-bit) | 🟢 Full | linux_arm64.tar.gz | superseriousbusiness/gotosocial:0.17.1 |
FreeBSD | x86-64/AMD64 (64-bit) | 🟢 Full1 | freebsd_amd64_moderncsqlite.tar.gz | None provided |
Linux | x86-32/i386 (32-bit) | 🟡 Partial2 | linux_386_moderncsqlite.tar.gz | superseriousbusiness/gotosocial:0.17.1-moderncsqlite |
Linux | Armv7/ARM32 (32-bit) | 🟡 Partial2 | linux_armv7_moderncsqlite.tar.gz | superseriousbusiness/gotosocial:0.17.1-moderncsqlite |
Linux | Armv6/ARM32 (32-bit) | 🟡 Partial2 | linux_armv6_moderncsqlite.tar.gz | superseriousbusiness/gotosocial:0.17.1-moderncsqlite |
FreeBSD
moderncsqlite
version currently recommended, though you might have success with the regular WASM SQLite version.
If running with regular WASM SQLite and having instability or memory issues, the following settings may help:
db-max-open-conns-multiplier: 0
db-sqlite-journal-mode: "TRUNCATE"
db-sqlite-synchronous: "FULL"
32-bit
moderncsqlite
version is needed, as performance with regular WASM SQLite is not guaranteed when running on 32-bit.
Remote media processing will likely not work with reasonable performance, so you should set the following config variables to prevent download of remote media onto your instance:
media-remote-max-size: 0
media-emoji-remote-max-size: 0
Changelog
Features and performance
- 8a93300: [feature] Add image descriptions for default avatar + header; don't allow editing default desc (#3473) (@tsmethurst)
Bug fixes
- ffc86f9: [bugfix] Fix occasionally streaming empty messages (#3456) (@tsmethurst)
- fab7d17: [bugfix] Fix filter title unique constraint (#3458) (@tsmethurst)
Chores & version bumps
- a48cce8: [chore] Upgrade golangci-lint, ignore existing int overflow warnings (#3420) (@untitaker)
- 9f6a1f7: [chore] Set some additional git attributes (#3454) (@daenney)
- 602c858: [chore] Thumbnail only first frame of animated media (#3448) (@tsmethurst)
- 0d0314b: [chore] Fix loop issue in streaming 🤦 (#3457) (@tsmethurst)
- ea1bf5f: [chore]: Bump github.com/yuin/goldmark from 1.7.6 to 1.7.8 (#3470) (@dependabot[bot])
- f301ec6: [chore]: Bump github.com/tdewolff/minify/v2 from 2.20.37 to 2.21.0 (#3468) (@dependabot[bot])
- e9299e1: [chore]: Bump github.com/prometheus/client_golang from 1.20.4 to 1.20.5 (#3469) (@dependabot[bot])
Documentation
v0.17.0 Selective Sloth
Hello everyone! This is the first ever BETA release of GoToSocial. Say hello to v0.17.0 Selective Sloth.
We've absolutely jam-packed this release with goodies!
Please read the migration notes carefully for instructions on how to upgrade to this version.
Release highlights
- Interaction policies: This release gives you the ability to set interaction policies on your statuses using the settings panel. Interaction policies let you determine who can reply to, like, or boost your statuses. You can accept or reject interactions as you wish; accepted replies will be added to your replies collection, and unwanted replies will be dropped. This feature is still a work-in-progress as we will almost certainly have some kinks to work out in terms of implementation etc, but we wanted to get it into people's hands as quickly as possible.
User docs here: https://docs.gotosocial.org/en/latest/user_guide/settings/#default-interaction-policies
Federation docs here: https://docs.gotosocial.org/en/latest/federation/posts/#interaction-policy - Much wider range of support for different media types: In this release we've embedded a webassembly build of ffmpeg into the GoToSocial binary, so that users can post many different types of media than previously, including mp3, flac, and other audio types, and many more video types. Admins: you don't need to have ffmpeg installed on your server for this to work.
- Audio player: to complement the new media types, we adapted our current video player to also play audio, so people visiting your profile can play MP3s and FLACs. Album art is supported when embedded in the audio file!
- Header/avatar alt text: You can now set alt-text for your avatar + header images, so that screenreader users visiting your profile can read a description of your beautiful face.
- Better threading model for statuses: On the web view of a thread, conversations are now indented at different levels, to make it easier to see who's replying to whom.
- Prefers-reduced-motion is now supported, so that folks with animations turned off in their operating system or browser aren't confronted with lots of animation when they open your profile.
- Conversations view: You can now view a list of your direct message conversations, making it much easier to keep track of who you're talking to.
- Import/export csv files: It's now possible to import Mastodon-compatible CSV files for accounts you follow and accounts you block, making it much easier to migrate across instances. Export of these files is supported too.
- Exclusive lists: You can now mark lists as "exclusive", which means that posts from accounts in an exclusive list will show up only in that list and not in your home timeline.
- Show/hide posts on your profile: Previously only Public posts were shown on your web profile. This is still the default, but you can now choose to show unlisted posts on your web profile too (the Mastodon default), or to show no posts at all.
- Lots of new themes: solarized, brutalist, ecks pee, and more.
- Store worker queue on restart: when you stop the instance, pending tasks are stored into the database, and loaded again when you start up the instance, so that no tasks get lost between restarts.
Migration notes
Upgrading
To upgrade to v0.17.0 from a previous release:
Binary/tar
- Stop GoToSocial.
- 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
. - Download and untar the new release, including the web assets and html templates.
- Edit your config.yaml file if necessary (see below).
- Start GoToSocial.
- 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!
- Enjoy your updated instance.
Docker
- Stop GoToSocial.
- 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
. - Pull the new docker container (
superseriousbusiness/gotosocial:0.17.0
orsuperseriousbusiness/gotosocial:latest
) - Edit your config.yaml file or environment variables if necessary (see below).
- Start GoToSocial.
- 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!
- Enjoy your updated instance.
config.yaml
The configuration file has changed since the previous release.
- Add
db-postgres-connection-string
. - Remove
media-image-max-size
andmedia-video-max-size
. - Add
media-local-max-size
andmedia-remote-max-size
. - Add
media-ffmpeg-pool-size
. - Add
storage-s3-redirect-url
. - Change
http-client.timeout
default from 10s to 30s to reduce occurrence of "could not download media" message.
You can see a diff of the config file here: v0.16.0...v0.17.0#diff-c071e03510b2c57e193a44503fd9528a785f0f411497cc75841a9f8d0b1ac622
Database Migrations
This release contains several VERY LONG 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 an hour or maybe even more (on slower hardware).
Please be patient!
Which release archive/container should I use?
Tl;dr: Regardless of whether you're using SQLite or Postgres as your DB driver, you most likely you want the regular version without moderncsqlite
in the name.
However, if you're on FreeBSD, 32-bit Linux or 32-bit ARM, we recommend using the moderncsqlite
version instead.
You may need to change some configuration options too. See the table below:
OS | Architecture | Support level | Binary archive | Docker |
---|---|---|---|---|
Linux | x86-64/AMD64 (64-bit) | 🟢 Full | linux_amd64.tar.gz | superseriousbusiness/gotosocial:0.17.0 |
Linux | Armv8/ARM64 (64-bit) | 🟢 Full | linux_arm64.tar.gz | superseriousbusiness/gotosocial:0.17.0 |
FreeBSD | x86-64/AMD64 (64-bit) | 🟢 Full1 | freebsd_amd64_moderncsqlite.tar.gz | None provided |
Linux | x86-32/i386 (32-bit) | 🟡 Partial2 | linux_386_moderncsqlite.tar.gz | superseriousbusiness/gotosocial:0.17.0-moderncsqlite |
Linux | Armv7/ARM32 (32-bit) | 🟡 Partial2 | linux_armv7_moderncsqlite.tar.gz | superseriousbusiness/gotosocial:0.17.0-moderncsqlite |
Linux | Armv6/ARM32 (32-bit) | 🟡 Partial2 | linux_armv6_moderncsqlite.tar.gz | superseriousbusiness/gotosocial:0.17.0-moderncsqlite |
FreeBSD
moderncsqlite
version currently recommended, though you might have success with the regular WASM SQLite version.
If running with regular WASM SQLite and having instability or memory issues, the following settings may help:
db-max-open-conns-multiplier: 0
db-sqlite-journal-mode: "TRUNCATE"
db-sqlite-synchronous: "FULL"
32-bit
moderncsqlite
version is needed, as performance with regular WASM SQLite is not guaranteed when running on 32-bit.
Remote media processing will likely not work with reasonable performance, so you should set the following config variables to prevent download of remote media onto your instance:
media-remote-max-size: 0
media-emoji-remote-max-size: 0
Changelog
Features and performance
- b08c1bd: [feature] Implement types[] param for notifications (#3009) (@VyrCossont)
- d2b3d37: [feature/frontend] Reports frontend v2 (#3022) (@tsmethurst)
- 7b1ccbd: [feature] add worker task serialization logic (#2989) (@NyaaaWhatsUpDo...
v0.17.0-rc5
Here's version 0.17.0-rc5 of GoToSocial.
We fixed a couple bugs! And changed some deployment stuff! And updated some library versions!
Please read the migration notes carefully for instructions on how to upgrade to this version!
Migration notes
Upgrading
To upgrade to v0.17.0-rc5 from a previous release:
Binary/tar
- Stop GoToSocial.
- 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
. - Download and untar the new release, including the web assets and html templates.
- Edit your config.yaml file if necessary (see below).
- Start GoToSocial.
- 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!
- Enjoy your updated instance.
Docker
- Stop GoToSocial.
- 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
. - Pull the new docker container (
superseriousbusiness/gotosocial:0.17.0-rc5
orsuperseriousbusiness/gotosocial:latest
) - Edit your config.yaml file or environment variables if necessary (see below).
- Start GoToSocial.
- 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!
- Enjoy your updated instance.
config.yaml
No configuration file changes in this release candidate compared to 0.17.0-rc4.
However, there are configuration file changes between this version and 0.16.0. Read the release notes of 0.17.0-rc1 for more information.
Database Migrations
No database migrations in this release candidate compared to 0.17.0-rc4.
However, there are some very long database migrations between this version and 0.16.0. Read the release notes of 0.17.0-rc1 for more information.
Which release archive/container should I use?
Tl;dr: Regardless of whether you're using SQLite or Postgres as your DB driver, you most likely you want the regular version without moderncsqlite
in the name.
However, if you're on FreeBSD, 32-bit Linux or 32-bit ARM, we recommend using the moderncsqlite
version instead.
You may need to change some configuration options too. See the table below:
OS | Architecture | Support level | Binary archive | Docker |
---|---|---|---|---|
Linux | x86-64/AMD64 (64-bit) | 🟢 Full | linux_amd64.tar.gz | superseriousbusiness/gotosocial:0.17.0-rc5 |
Linux | Armv8/ARM64 (64-bit) | 🟢 Full | linux_arm64.tar.gz | superseriousbusiness/gotosocial:0.17.0-rc5 |
FreeBSD | x86-64/AMD64 (64-bit) | 🟢 Full1 | freebsd_amd64_moderncsqlite.tar.gz | None provided |
Linux | x86-32/i386 (32-bit) | 🟡 Partial2 | linux_386_moderncsqlite.tar.gz | superseriousbusiness/gotosocial:0.17.0-rc5-moderncsqlite |
Linux | Armv7/ARM32 (32-bit) | 🟡 Partial2 | linux_armv7_moderncsqlite.tar.gz | superseriousbusiness/gotosocial:0.17.0-rc5-moderncsqlite |
Linux | Armv6/ARM32 (32-bit) | 🟡 Partial2 | linux_armv6_moderncsqlite.tar.gz | superseriousbusiness/gotosocial:0.17.0-rc5-moderncsqlite |
Linux | x86-32/i386 (32-bit) | 🟡 Partial2 | linux_386_moderncsqlite.tar.gz | superseriousbusiness/gotosocial:0.17.0-rc5-moderncsqlite |
FreeBSD
moderncsqlite
version currently recommended, though you might have success with the regular WASM SQLite version.
If running with regular WASM SQLite and having instability or memory issues, the following settings may help:
db-max-open-conns-multiplier: 0
db-sqlite-journal-mode: "TRUNCATE"
db-sqlite-synchronous: "FULL"
32-bit
moderncsqlite
version is needed, as performance with regular WASM SQLite is not guaranteed when running on 32-bit.
Remote media processing will likely not work with reasonable performance, so you should set the following config variables to prevent download of remote media onto your instance:
media-remote-max-size: 0
media-emoji-remote-max-size: 0
What's Changed
- [bugfix] Account.last_status_at is a date, not datetime by @untitaker in #3419
- [chore] Update goreleaser, add release notes template by @tsmethurst in #3421
- [chore] goreleaser - use custom previous tag by @tsmethurst in #3422
- [chore/bugfix] goreleaser make previous_tag cmd busybox-compatible by @tsmethurst in #3423
- [chore] Ensure current tag not set as
GORELEASER_PREVIOUS_TAG
by @tsmethurst in #3424 - [docs] fix httpsig repo typo by @cy7sh in #3426
- [chore/docs] Add
/gotosocial/.cache
to Docker container, documentGTS_WAZERO_COMPILATION_CACHE
by @tsmethurst in #3425 - [feature] for an sqlite database with journal mode != WAL, use maximum of 1 open connection by @NyaaaWhatsUpDoc in #3428
- [chore] Clarify supported platforms, add notes + docs by @tsmethurst in #3427
- [chore]: Bump github.com/yuin/goldmark from 1.7.4 to 1.7.6 by @dependabot in #3430
- [chore]: Bump github.com/minio/minio-go/v7 from 7.0.77 to 7.0.78 by @dependabot in #3431
- [feature/OFFICIALLY UNSUPPORTED] add nowasm build tag to disable building with WebAssembly by @NyaaaWhatsUpDoc in #3429
- [docs] Document experimental, unsupported
nowasm
tag by @tsmethurst in #3436
Full Changelog: v0.17.0-rc4...v0.17.0-rc5
v0.17.0-rc4
If updating to this release candidate from another 0.17.0 release candidate, there's one smaller migration which should take something like a minute to ten minutes depending on your software. Please be patient!
For instructions to update to this release candidate from versions < v0.17.0-rc1, see the v0.17.0-rc1 release candidate notes, but replace v0.17.0-rc1
with v0.17.0-rc4
throughout.
No config file changes between other release candidates and this version.
Which release archive/container should I use?
Tl;dr: Regardless of whether you're using SQLite or Postgres as your DB driver, you most likely you want the regular version without moderncsqlite
in the name.
However, if you're on FreeBSD or OpenBSD, use the moderncsqlite
version instead. See the table below:
OS | Architecture | Binary archive | Docker |
---|---|---|---|
Linux | x86-64/AMD64 (64-bit) | linux_amd64.tar.gz | superseriousbusiness/gotosocial:0.17.0-rc4 |
Linux | x86-32/i386 (32-bit) | linux_386.tar.gz | superseriousbusiness/gotosocial:0.17.0-rc4 |
Linux | Armv8/ARM64 (64-bit) | linux_arm64.tar.gz | superseriousbusiness/gotosocial:0.17.0-rc4 |
Linux | Armv7/ARM32 (32-bit) | linux_armv7.tar.gz | superseriousbusiness/gotosocial:0.17.0-rc4 |
Linux | Armv6/ARM32 (32-bit) | linux_armv6.tar.gz | superseriousbusiness/gotosocial:0.17.0-rc4 |
OpenBSD | x86-64/AMD64 (64-bit) | openbsd_amd64_moderncsqlite.tar.gz | superseriousbusiness/gotosocial:0.17.0-rc4-moderncsqlite |
FreeBSD | x86-64/AMD64 (64-bit) | freebsd_amd64_moderncsqlite.tar.gz | superseriousbusiness/gotosocial:0.17.0-rc4-moderncsqlite |
Changes
- [chore] Create modernc sqlite builds alongside default wasm; add openbsd builds by @tsmethurst in #3413
- [bugfix] Ensure
pending_approval
set on statuses + status faves by @tsmethurst in #3415 - [bugfix] Check interaction policies properly on incoming Likes by @tsmethurst in #3416
- [chore] Don't cc Accept of likes to followers by @tsmethurst in #3417
Full Changelog: v0.17.0-rc3...v0.17.0-rc4
v0.17.0-rc3
For instructions to update to this release candidate from versions < v0.17.0-rc1, see the v0.17.0-rc1 release candidate notes, but replace v0.17.0-rc1
with v0.17.0-rc3
throughout.
No config file changes between v0.17.0-rc2 or v0.17.0-rc1 and this version.
Bugfixes
- [bugfix] Fix replies not being stored pending approval by @tsmethurst in #3409
- [bugfix] Add missing
</a>
on about page by @tsmethurst in #3410 - [bugfix/frontend] Don't show replies to hidden parents; return 404 if no "main" thread by @tsmethurst in #3411
Full Changelog: v0.17.0-rc2...v0.17.0-rc3
v0.17.0-rc2
For instructions to update to this release candidate from versions < v0.17.0-rc1, see the v0.17.0-rc1 release candidate notes, but replace v0.17.0-rc1
with v0.17.0-rc2
throughout.
If updating from 0.17.0-rc1 to this version, there's a small index update that needs to run, which should be very fast.
No config file changes between v0.17.0-rc1 and this version.
Detailed changelog
Features / performance
- [performance] remove the sqlite pragma optimize analysis limit on connection close by @NyaaaWhatsUpDoc in #3386
- [feature/frontend] Add Moonlight hunt theme by @tsmethurst in #3393
- [feature] Distribute Accepts to followers; process Accepts of remote interactions by @tsmethurst in #3404
Bugfixes
- [bugfix] Fix incorrect reply shown in interaction request by @tsmethurst in #3344
- [bugfix] s3 media uploaded without content-type by @NyaaaWhatsUpDoc in #3353
- [bugfix] fix media limit reader check by @NyaaaWhatsUpDoc in #3363
- [bugfix] better handle ogg container format by @NyaaaWhatsUpDoc in #3365
- [bugfix] visibility after implicit approval not getting invalidated by @NyaaaWhatsUpDoc in #3370
- [bugfix] Carry-over "PinnedAt" when refreshing status by @tsmethurst in #3373
- [bugfix] fix slice init length by @cuishuang in #3382
- [bugfix] Include own account in conversation when no other accounts involved by @tsmethurst in #3387
- [bugfix] Don't try to add nil filtered statuses to context by @tsmethurst in #3388
- [bugfix] Account for nil reply when serializing int req by @tsmethurst in #3389
- [bugfix] Update select of pending interaction requests to account for potential nil URI by @tsmethurst in #3392
- [bugfix] Return 501 (not implemented) if user tries to schedule post by @tsmethurst in #3395
- [bugfix] Only allow boosting post from non-interaction-policy-aware instance if public or unlisted by @tsmethurst in #3396
Chores
- [chore] reduce number admin process workers by @NyaaaWhatsUpDoc in #3354
- [chore] Fix some contrast issues in themes; performance tweaks by @tsmethurst in #3358
- [chore] update go-sched pkg by @NyaaaWhatsUpDoc in #3357
- [chore] bump go-byteutil v1.2.0 -> v1.3.0 by @NyaaaWhatsUpDoc in #3356
- [chore] update gruf / {go-cache, go-maps, go-kv} by @NyaaaWhatsUpDoc in #3361
- [chore] final bits of fiddling with solarized by @tsmethurst in #3364
- [chore] update modernc/sqlite to v1.33.1 (with our concurrency workaround) by @NyaaaWhatsUpDoc in #3367
- [chore] Update apparmor example file by @tsmethurst in #3368
- [chore] use string formatting package agnostic way of printing request attemps by @NyaaaWhatsUpDoc in #3371
- [chore]: Bump github.com/ncruces/go-sqlite3 from 0.18.3 to 0.18.4 by @dependabot in #3375
- [chore]: Bump go.uber.org/automaxprocs from 1.5.3 to 1.6.0 by @dependabot in #3376
- [chore] update go-structr to v0.8.11 by @NyaaaWhatsUpDoc in #3380
- [chore] Change order of error checking after PostInbox by @tsmethurst in #3394
- [chore/themes] Tweak colors on new themes by @tsmethurst in #3397
- [chore] update go-ffmpreg to v0.3.1 by @NyaaaWhatsUpDoc in #3398
- [chore]: Bump golang.org/x/net from 0.29.0 to 0.30.0 by @dependabot in #3402
- [chore]: Bump golang.org/x/image from 0.20.0 to 0.21.0 by @dependabot in #3399
- [chore] update go-sqlite3 to v0.19.0 by @NyaaaWhatsUpDoc in #3406
Docs
- [docs] Don't run SQLite on networked storage by @daenney in #3369
- [docs] Update smtp docs to mention starttls + port 587 by @tsmethurst in #3378
- [docs] Make
protocol
config option really explicit by @tsmethurst in #3391
Full Changelog: v0.17.0-rc1...v0.17.0-rc2
v0.17.0-rc1
Release highlights
Hello everyone! This is the first release candidate for v0.17.0 of GoToSocial! We've absolutely jam-packed this release (candidate) with goodies:
- Interaction policies: This release gives you the ability to set interaction policies on your statuses using the settings panel. Interaction policies let you determine who can reply to, like, or boost your statuses. You can accept or reject interactions as you wish; accepted replies will be added to your replies collection, and unwanted replies will be dropped. This feature is still a work-in-progress as we will almost certainly have some kinks to work out in terms of implementation etc, but we wanted to get it into people's hands as quickly as possible.
User docs here: https://docs.gotosocial.org/en/latest/user_guide/settings/#default-interaction-policies
Federation docs here: https://docs.gotosocial.org/en/latest/federation/posts/#interaction-policy - Much wider range of support for different media types: In this release we've embedded a webassembly build of ffmpeg into the GoToSocial binary, so that users can post many different types of media than previously, including mp3, flac, and other audio types, and many more video types. Admins: you don't need to have ffmpeg installed on your server for this to work.
- Audio player: to complement the new media types, we adapted our current video player to also play audio, so people visiting your profile can play MP3s and FLACs. Album art is supported when embedded in the audio file!
- Header/avatar alt text: You can now set alt-text for your avatar + header images, so that screenreader users visiting your profile can read a description of your beautiful face.
- Better threading model for statuses: On the web view of a thread, conversations are now indented at different levels, to make it easier to see who's replying to whom.
- Prefers-reduced-motion is now supported, so that folks with animations turned off in their operating system or browser aren't confronted with lots of animation when they open your profile.
- Conversations view: You can now view a list of your direct message conversations, making it much easier to keep track of who you're talking to.
- Import/export csv files: It's now possible to import Mastodon-compatible CSV files for accounts you follow and accounts you block, making it much easier to migrate across instances. Export of these files is supported too.
- Exclusive lists: You can now mark lists as "exclusive", which means that posts from accounts in an exclusive list will show up only in that list and not in your home timeline.
- Show/hide posts on your profile: Previously only Public posts were shown on your web profile. This is still the default, but you can now choose to show unlisted posts on your web profile too (the Mastodon default), or to show no posts at all.
- Lots of new themes: solarized, brutalist, ecks pee, and more.
- Store worker queue on restart: when you stop the instance, pending tasks are stored into the database, and loaded again when you start up the instance, so that no tasks get lost between restarts.
Migration notes
Upgrading
To upgrade to 0.17.0-rc1 from a previous release:
Binary/tar
- Stop GoToSocial
- Back up your database! For sqlite, this is as simple as copying your
sqlite.db
file. - Untar the new release, including the web assets and html templates.
- Edit your config.yaml file as necessary (see below).
- Start GoToSocial
- Wait patiently for migrations to run and do not interrupt them.
Docker
- Stop GoToSocial.
- Back up your database! For sqlite, this is as simple as copying your
sqlite.db
file. - Pull the new docker container (
superseriousbusiness/gotosocial:0.17.0-rc1
orsuperseriousbusiness/gotosocial:latest
) - Edit your config.yaml file as necessary (see below).
- Start GoToSocial.
- Wait patiently for migrations to run and do not interrupt them.
config.yaml
The configuration file has changed since the previous release. You can see a diff of the config file here: v0.16.0...v0.17.0-rc1#diff-c071e03510b2c57e193a44503fd9528a785f0f411497cc75841a9f8d0b1ac622
- Add
db-postgres-connection-string
. - Remove
media-image-max-size
andmedia-video-max-size
. - Add
media-local-max-size
andmedia-remote-max-size
. - Add
media-ffmpeg-pool-size
. - Add
storage-s3-redirect-url
. - Change
http-client.timeout
default from 10s to 30s to reduce occurrence of "could not download media" message.
Database Migrations
Detailed changelist
Features + performance
- [feature] Implement types[] param for notifications by @VyrCossont in #3009
- [feature/frontend] Reports frontend v2 by @tsmethurst in #3022
- [feature] add worker task serialization logic by @NyaaaWhatsUpDoc in #2989
- [feature] Rain Forest Theme by @xmgz in #3021
- [feature] Default to WASM-based SQLite driver by @daenney in #3053
- [feature] Set some security related headers by @daenney in #3065
- [feature/frontend] Allow setting alt-text for avatar + header by @tsmethurst in #3086
- [feature] support processing of (many) more media types by @NyaaaWhatsUpDoc in #3090
- [feature/frontend] Better visual separation between "main" thread and "replies" by @tsmethurst in #3093
- [feature/frontend] Add player for audio files; use thumbnail for
poster
by @tsmethurst in #3099 - [feature] more filetype support! by @NyaaaWhatsUpDoc in #3107
- [feature] Allow users to set default interaction policies per status visibility by @tsmethurst in #3108
- [feature] use webp for thumbnails by @NyaaaWhatsUpDoc in #3116
- [feature/frontend] Respect
prefers-reduced-motion
for avatars, headers, and emojis by @tsmethurst in #3118 - [feature] add flac support by @NyaaaWhatsUpDoc in #3121
- [feature] Conversations API by @VyrCossont in #3013
- [feature] Allow user to set "bot" flag; show bot icon on profile by @tsmethurst in #3135
- [feature] Federate interaction policies + Accepts; enforce policies by @tsmethurst in #3138
- [feature] Implement following hashtags by @VyrCossont in #3141
- [feature] persist worker queues to db by @NyaaaWhatsUpDoc in #3042
- [performance] limit ffprobe read time to at most 1s after start of file by @NyaaaWhatsUpDoc in #3155
- [feature] Object store custom URL (S3) by @CDN18 in #3046
- [feature] Allow users to export data via the settings panel by @tsmethurst in #3140
- [feature] Implement Mastodon-compatible roles by @VyrCossont in #3136
- [feature] Allow import of following and blocks via CSV by @tsmethurst in #3150
- [feature] Beef up our AI opt-outs by @daenney in #3165
- [feature] Use gifv type for short soundless mp4 videos by @tsmethurst in #3182
- handle db-url by @winston0410 in #3178
- [performance] move thumbnail generation to go code where possible by @NyaaaWhatsUpDoc in #3183
- [performance] use native Go code to probe JPEGs by @NyaaaWhatsUpDoc in #3206
- [feature] Use
local_only
field, deprecatefederated
field by @tsmethurst in #3222 - [performance] ffmpeg ffprobe wrapper improvements by @NyaaaWhatsUpDoc in #3225
- [feature] Interaction requests client api + settings panel by @tsmethurst in #3215
- [performance] use single-threaded image transfor...