@matt Do you mean this guide?

https://docs.joinmastodon.org/admin/upgrading/

@Mastodon yes it's horrible. I follow that and get nothing but 500 errors after doing it.

@matt People often miss this sentence: "The release page contains a changelog, and below it, upgrade instructions"

You need to follow the instructions on the particular release's page. Have you done that? Or have you only executed assets:precompile which is the example given below?

@Mastodon
@matt

> People often miss

might be a documentation design bug?

@deejoe @matt No doubt. The page needs rework. This conversation might highlight all that's unclear about it.

@Mastodon @deejoe It might be nice to just include upgrade instructions on a single page so there is no confusion. just my two cents.

@matt @Mastodon

then it has every version, becomes long, and people complain about *that* or don't read it

@deejoe @Mastodon This dude has the best instructions. I am running into the same errors he is and he explains how to fix it.

Shame your documentation doesn't include that. https://fedi.dev/gytis/update-mastodon-server-instance

@Mastodon I've tried to locate it. I guess it's not clear enough to me where to gather that.

@matt Here is the release page for v3.1.0:

https://github.com/tootsuite/mastodon/releases/tag/v3.1.0

v3.1.0 was immediately replaced by v3.1.1 so all these notes are for v3.1.1 as well. Scroll down to "Upgrade instructions".

@matt @Mastodon do you have some log entries to check what went wrong and what was the cause of the 500 errors?
You were some trouble with login in your instance apparently before as well:

https://discourse.joinmastodon.org/t/bug-in-code-error-after-login/2478/2

It is best to provide output from logs for troubleshooting..

@saper @matt Based on what was said I think this is simply a matter of database migrations not having been run.

@Mastodon @saper I was getting an error before getting to database migration and didn't know what to do

@Mastodon @saper I'll attempt to upgrade again soon and let you know what comes of it.

@Mastodon @saper @Gargron I finally got my #mastodon instance upgraded however I'm missing all the new features such as announcements, and bookmarks.

Why??