AkkomaGang/akkoma
AkkomaGang
/
akkoma
12
63
Fork 83
Code Issues 169 Pull Requests 16 Packages Projects 2 Releases 13 Wiki Activity
akkoma/docs/docs/administration/updating.md

32 lines
1.3 KiB
Markdown
Raw Normal View History

Move out of Gitlab Wiki I understand that this change is quite unreadable and hard to review, sorry for forgetting to do atomic commits. This patch does not change too much content wise, it just * Gets everything from gitlab wiki * Removes some specific gitlab hacks * Formats all documentation file names to be in snake case so they look the same way as our code does
2019-03-28 16:46:30 +00:00
# Updating your instance
Add OTP to updating.md * I removed the Update section from the OTP install and added it to updating.md * I also added a link to the updating.md from the OTP install page * I added a Questions section to the OTP install, similar to the debian_based_en.md * Restructured the updating.md a bit I would very much also like to link to the changelog, but I don't know how to do it because I can't find the page in the docs?
2020-01-15 08:12:24 +00:00
Update administration docs (#39) Reviewed-on: https://akkoma.dev/AkkomaGang/akkoma/pulls/39 Co-authored-by: norm <normandy@biribiri.dev> Co-committed-by: norm <normandy@biribiri.dev>
2022-07-03 15:18:43 +00:00
You should **always check the [release notes/changelog](https://akkoma.dev/AkkomaGang/akkoma/src/branch/develop/CHANGELOG.md)** in case there are config deprecations, special update steps, etc.
Add OTP to updating.md * I removed the Update section from the OTP install and added it to updating.md * I also added a link to the updating.md from the OTP install page * I added a Questions section to the OTP install, similar to the debian_based_en.md * Restructured the updating.md a bit I would very much also like to link to the changelog, but I don't know how to do it because I can't find the page in the docs?
2020-01-15 08:12:24 +00:00
Besides that, doing the following is generally enough:
## For OTP installations
```sh
# Download the new release
Documentation updates for stable release (#73) Reviewed-on: https://akkoma.dev/AkkomaGang/akkoma/pulls/73
2022-07-15 12:27:16 +00:00
su akkoma -s $SHELL -lc "./bin/pleroma_ctl update"
Add OTP to updating.md * I removed the Update section from the OTP install and added it to updating.md * I also added a link to the updating.md from the OTP install page * I added a Questions section to the OTP install, similar to the debian_based_en.md * Restructured the updating.md a bit I would very much also like to link to the changelog, but I don't know how to do it because I can't find the page in the docs?
2020-01-15 08:12:24 +00:00
# Migrate the database, you are advised to stop the instance before doing that
Update administration docs (#39) Reviewed-on: https://akkoma.dev/AkkomaGang/akkoma/pulls/39 Co-authored-by: norm <normandy@biribiri.dev> Co-committed-by: norm <normandy@biribiri.dev>
2022-07-03 15:18:43 +00:00
su akkoma -s $SHELL -lc "./bin/pleroma_ctl migrate"
Add OTP to updating.md * I removed the Update section from the OTP install and added it to updating.md * I also added a link to the updating.md from the OTP install page * I added a Questions section to the OTP install, similar to the debian_based_en.md * Restructured the updating.md a bit I would very much also like to link to the changelog, but I don't know how to do it because I can't find the page in the docs?
2020-01-15 08:12:24 +00:00
```
Add installation note about flavour, support special cases (#222) Fixes #210 Co-authored-by: FloatingGhost <hannah@coffee-and-dreams.uk> Reviewed-on: https://akkoma.dev/AkkomaGang/akkoma/pulls/222
2022-09-20 11:04:26 +00:00
If you selected an alternate flavour on installation,
you _may_ need to specify `--flavour`, in the same way as
[when installing](../../installation/otp_en#detecting-flavour).
Add OTP to updating.md * I removed the Update section from the OTP install and added it to updating.md * I also added a link to the updating.md from the OTP install page * I added a Questions section to the OTP install, similar to the debian_based_en.md * Restructured the updating.md a bit I would very much also like to link to the changelog, but I don't know how to do it because I can't find the page in the docs?
2020-01-15 08:12:24 +00:00
## For from source installations (using git)
Update administration docs (#39) Reviewed-on: https://akkoma.dev/AkkomaGang/akkoma/pulls/39 Co-authored-by: norm <normandy@biribiri.dev> Co-committed-by: norm <normandy@biribiri.dev>
2022-07-03 15:18:43 +00:00
1. Go to the working directory of Akkoma (default is `/opt/akkoma`)
Instruct users to run 'git pull' as the pleroma user
2022-05-12 16:02:58 +00:00
2. Run `git pull` [^1]. This pulls the latest changes from upstream.
Add mention of sudo -Hu pleroma to docs
2020-08-28 13:50:21 +00:00
3. Run `mix deps.get` [^1]. This pulls in any new dependencies.
Update administration docs (#39) Reviewed-on: https://akkoma.dev/AkkomaGang/akkoma/pulls/39 Co-authored-by: norm <normandy@biribiri.dev> Co-committed-by: norm <normandy@biribiri.dev>
2022-07-03 15:18:43 +00:00
4. Stop the Akkoma service.
Add mention of sudo -Hu pleroma to docs
2020-08-28 13:50:21 +00:00
5. Run `mix ecto.migrate` [^1] [^2]. This task performs database migrations, if there were any.
Update administration docs (#39) Reviewed-on: https://akkoma.dev/AkkomaGang/akkoma/pulls/39 Co-authored-by: norm <normandy@biribiri.dev> Co-committed-by: norm <normandy@biribiri.dev>
2022-07-03 15:18:43 +00:00
6. Start the Akkoma service.
Move out of Gitlab Wiki I understand that this change is quite unreadable and hard to review, sorry for forgetting to do atomic commits. This patch does not change too much content wise, it just * Gets everything from gitlab wiki * Removes some specific gitlab hacks * Formats all documentation file names to be in snake case so they look the same way as our code does
2019-03-28 16:46:30 +00:00
Update administration docs (#39) Reviewed-on: https://akkoma.dev/AkkomaGang/akkoma/pulls/39 Co-authored-by: norm <normandy@biribiri.dev> Co-committed-by: norm <normandy@biribiri.dev>
2022-07-03 15:18:43 +00:00
[^1]: Depending on which install guide you followed (for example on Debian/Ubuntu), you want to run `git` and `mix` tasks as `akkoma` user by adding `sudo -Hu akkoma` before the command.
Add mention of sudo -Hu pleroma to docs
2020-08-28 13:50:21 +00:00
[^2]: Prefix with `MIX_ENV=prod` to run it using the production config file.