No OneTemporary
Actions

Size

261 KB

Referenced Files

None

Subscribers

None

View Options

This file is larger than 256 KB, so syntax highlighting was skipped.

	diff --git a/CHANGELOG.md b/CHANGELOG.md
	index 18ed8c8ae..723c1060f 100644
	--- a/CHANGELOG.md
	+++ b/CHANGELOG.md
	@@ -1,1609 +1,1611 @@
	# Changelog

	All notable changes to this project will be documented in this file.

	The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).

	## Unreleased

	## Added
	- Support for [FEP-fffd](https://codeberg.org/fediverse/fep/src/branch/main/fep/fffd/fep-fffd.md) (proxy objects)
	- Verified support for elixir 1.16
	+- Uploadfilter `Pleroma.Upload.Filter.Exiftool.ReadDescription` returns description values to the FE so they can pre fill the image description field

	## Changed
	- Inbound pipeline error handing was modified somewhat, which should lead to less incomprehensible log spam. Hopefully.
	+- Uploadfilter `Pleroma.Upload.Filter.Exiftool` has been renamed to `Pleroma.Upload.Filter.Exiftool.StripMetadata`

	## Fixed
	- Issue preventing fetching anything from IPv6-only instances
	- Issue allowing post content to leak via opengraph tags despite :estrict\_unauthenticated being set

	## 2024.03

	## Added
	- CLI tasks best-effort checking for past abuse of the recent spoofing exploit
	- new `:mrf_steal_emoji, :download_unknown_size` option; defaults to `false`

	## Changed
	- `Pleroma.Upload, :base_url` now MUST be configured explicitly if used;
	use of the same domain as the instance is strongly discouraged
	- `:media_proxy, :base_url` now MUST be configured explicitly if used;
	use of the same domain as the instance is strongly discouraged
	- StealEmoji:
	- now uses the pack.json format;
	existing users must migrate with an out-of-band script (check release notes)
	- only steals shortcodes recognised as valid
	- URLs of stolen emoji is no longer predictable
	- The `Dedupe` upload filter is now always active;
	`AnonymizeFilenames` is again opt-in
	- received AP data is sanity checked before we attempt to parse it as a user
	- Uploads, emoji and media proxy now restrict Content-Type headers to a safe subset
	- Akkoma will no longer fetch and parse objects hosted on the same domain

	## Fixed
	- Critical security issue allowing Akkoma to be used as a vector for
	(depending on configuration) impersonation of other users or creation
	of bogus users and posts on the upload domain
	- Critical security issue letting Akkoma fall for the above impersonation
	payloads due to lack of strict id checking
	- Critical security issue allowing domains redirect to to pose as the initial domain
	(e.g. with media proxy's fallback redirects)
	- refetched objects can no longer attribute themselves to third-party actors
	(this had no externally visible effect since actor info is read from the Create activity)
	- our litepub JSON-LD schema is now served with the correct content type
	- remote APNG attachments are now recognised as images

	## Upgrade Notes

	- As mentioned in "Changed", `Pleroma.Upload, :base_url` MUST be configured. Uploads will fail without it.
	- Akkoma will refuse to start if this is not set.
	- Same with media proxy.

	## 2024.02

	## Added
	- Full compatibility with Erlang OTP26
	- handling of GET /api/v1/preferences
	- Akkoma API is now documented
	- ability to auto-approve follow requests from users you are already following
	- The SimplePolicy MRF can now strip user backgrounds from selected remote hosts

	## Changed
	- OTP builds are now built on erlang OTP26
	- The base Phoenix framework is now updated to 1.7
	- An `outbox` field has been added to actor profiles to comply with AP spec
	- User profile backgrounds do now federate with other Akkoma instances and Sharkey

	## Fixed
	- Documentation issue in which a non-existing nginx file was referenced
	- Issue where a bad inbox URL could break federation
	- Issue where hashtag rel values would be scrubbed
	- Issue where short domains listed in `transparency_obfuscate_domains` were not actually obfuscated

	## 2023.08

	## Added

	- Added a new configuration option to the MediaProxy feature that allows the blocking of specific domains from using the media proxy or being explicitly allowed by the Content-Security-Policy.
	- Please make sure instances you wanted to block media from are not in the MediaProxy `whitelist`, and instead use `blocklist`.
	- `OnlyMedia` Upload Filter to simplify restricting uploads to audio, image, and video types
	- ARM64 OTP builds
	- Ubuntu22 builds are available for develop and stable
	- other distributions are stable only
	- Support for Elixir 1.15
	- 1.14 is still supported
	- OTP26 is currently "unsupported". It will probably work, but due to the way
	it handles map ordering, the test suite will not pass for it as yet.

	## Changed

	- Alpine OTP builds are now from alpine 3.18, which is OpenSSLv3 compatible.
	If you use alpine OTP builds you will have to update your local system.
	- Debian OTP builds are now from a base of bookworm, which is OpenSSLv3 compatible.
	If you use debian OTP builds you will have to update your local system to
	bookworm (currently: stable).
	- Ubuntu and debian builds are compatible again! (for now...)
	- Blocks/Mutes now return from max ID to min ID, in line with mastodon.
	- The AnonymizeFilename filter is now enabled by default.

	## Fixed

	- Deactivated users can no longer show up in the emoji reaction list
	- Embedded posts can no longer bypass `:restrict\_unauthenticated`
	- GET/HEAD requests will now work when requesting AWS-based instances.

	## Security

	- Add `no_new_privs` hardening to OpenRC and systemd service files
	- XML parsers cannot load any entities (thanks @Mae@is.badat.dev!)
	- Reduced permissions of config files and directories, distros requiring greater permissions like group-read need to pre-create the directories

	## Removed

	- Builds for debian oldstable (bullseye)
	- If you are on oldstable you should NOT attempt to update OTP builds without
	first updating your machine.

	## 2023.05

	## Added
	- Custom options for users to accept/reject private messages
	- options: everybody, nobody, people\_i\_follow
	- MRF to reject notes from accounts newer than a given age
	- this will have the side-effect of rejecting legitimate messages if your
	post gets boosted outside of your local bubble and people your instance
	does not know about reply to it.

	## Fixed
	- Support for `streams` public key URIs
	- Bookmarks are cleaned up on DB prune now

	## Security
	- Fixed mediaproxy being a bit of a silly billy

	## 2023.04

	## Added
	- Nodeinfo keys for unauthenticated timeline visibility
	- Option to disable federated timeline
	- Option to make the bubble timeline publicly accessible
	- Ability to swap between installed standard frontends
	- mastodon frontends are still not counted as standard frontends due to the complexity in serving them correctly.

	### Upgrade Notes
	- Elixir 1.14 is now required. If your distribution does not package this, you can
	use [asdf](https://asdf-vm.com/). At time of writing, elixir 1.14.3 / erlang 25.3
	is confirmed to work.

	## 2023.03

	## Fixed
	- Allowed contentMap to be updated on edit
	- Filter creation now accepts expires\_at

	### Changed
	- Restoring the database from a dump now goes much faster without need for work-arounds
	- Misskey reaction matching uses `content` parameter now

	### Added
	- Extend the mix task `prune_objects` with option `--prune-orphaned-activities` to also prune orphaned activities, allowing to reclaim even more database space

	### Removed
	- Possibility of using the `style` parameter on `span` elements. This will break certain MFM parameters.
	- Option for "default" image description.

	## 2023.02

	### Added
	- Prometheus metrics exporting from `/api/v1/akkoma/metrics`
	- Ability to alter http pool size
	- Translation of statuses via ArgosTranslate
	- Argon2 password hashing
	- Ability to "verify" links in profile fields via rel=me
	- Mix tasks to dump/load config to/from json for bulk editing
	- Followed hashtag list at /api/v1/followed\_tags, API parity with mastodon
	- Ability to set posting language in the post form, API parity with mastodon
	- Ability to match domains in MRF by a trailing wildcard
	- Currently supported formats:
	- `example.com` (implicitly matches `*.example.com`)
	- `*.example.com`
	- `example.` (implicitly matches `.example.*`)

	### Removed
	- Non-finch HTTP adapters
	- Legacy redirect from /api/pleroma/admin to /api/v1/pleroma/admin
	- Legacy redirects from /api/pleroma to /api/v1/pleroma
	- :crypt dependency

	### Changed
	- Return HTTP error 413 when uploading an avatar or banner that's above the configured upload limit instead of a 500.
	- Non-admin users now cannot register `admin` scope tokens (not security-critical, they didn't work before, but you _could_ create them)
	- Admin scopes will be dropped on create
	- Rich media will now backoff for 20 minutes after a failure
	- Quote posts are now considered as part of the same thread as the post they are quoting
	- Extend the mix task `prune_objects` with options to keep more relevant posts
	- Simplified HTTP signature processing
	- Rich media will now hard-exit after 5 seconds, to prevent timeline hangs
	- HTTP Content Security Policy is now far more strict to prevent any potential XSS/CSS leakages
	- Follow requests are now paginated, matches mastodon API spec, so use the Link header to paginate.

	### Fixed
	- /api/v1/accounts/lookup will now respect restrict\_unauthenticated
	- Unknown atoms in the config DB will no longer crash akkoma on boot

	### Upgrade notes
	- Ensure `config :tesla, :adapter` is either unset, or set to `{Tesla.Adapter.Finch, name: MyFinch}` in your .exs config
	- Pleroma-FE will need to be updated to handle the new /api/v1/pleroma endpoints for custom emoji

	## 2022.12

	## Added
	- Config: HTTP timeout options, :pool\_timeout and :receive\_timeout
	- Added statistic gathering about instances which do/don't have signed fetches when they request from us
	- Ability to set a default post expiry time, after which the post will be deleted. If used in concert with ActivityExpiration MRF, the expiry which comes _sooner_ will be applied.
	- Regular task to prune local transient activities
	- Task to manually run the transient prune job (pleroma.database prune\_task)
	- Ability to follow hashtags
	- Option to extend `reject` in MRF-Simple to apply to entire threads, where the originating instance is rejected
	- Extra information to failed HTTP requests

	## Changed
	- MastoAPI: Accept BooleanLike input on `/api/v1/accounts/:id/follow` (fixes follows with mastodon.py)
	- Relays from akkoma are now off by default
	- NormalizeMarkup MRF is now on by default
	- Follow/Block/Mute imports now spin off into n tasks to avoid the oban timeout
	- Transient activities recieved from remote servers are no longer persisted in the database
	- Overhauled static-fe view for logged-out users
	- Blocked instances will now not be sent _any_ requests, even fetch ones that would get rejected by MRF anyhow

	## Removed
	- FollowBotPolicy
	- Passing of undo/block into MRF

	## Upgrade Notes
	- If you have an old instance, you will probably want to run `mix pleroma.database prune_task` in the foreground to catch it up with the history of your instance.

	## 2022.11

	## Added
	- Officially supported docker release
	- Ability to remove followers unilaterally without a block
	- Scraping of nodeinfo from remote instances to display instance info
	- `requested_by` in relationships when the user has requested to follow you

	## Changed
	- Follows no longer override domain blocks, a domain block is final
	- Deletes are now the lowest priority to publish and will be handled after creates
	- Domain blocks are now subdomain-matches by default

	## Fixed
	- Registrations via ldap are now compatible with the latest OTP24

	## Update notes
	- If you use LDAP and run from source, please update your elixir/erlang
	to the latest. The changes in OTP24.3 are breaking.
	- You can now remove the leading `*.` from domain blocks, but you do not have to.

	## 2022.10

	### Added
	- Ability to sync frontend profiles between clients, with a name attached
	- Status card generation will now use the media summary if it is available

	### Changed
	- Emoji updated to latest 15.0 draft
	- Breaking: `/api/v1/pleroma/backups` endpoints now requires `read:backups` scope instead of `read:accounts`
	- Verify that the signature on posts is not domain blocked, and belongs to the correct user

	### Fixed
	- OAuthPlug no longer joins with the database every call and uses the user cache
	- Undo activities no longer try to look up by ID, and render correctly
	- prevent false-errors from meilisearch

	## 2022.09

	### Added
	- support for fedibird-fe, and non-breaking API parity for it to function
	- support for setting instance languages in metadata
	- support for reusing oauth tokens, and not requiring new authorizations
	- the ability to obfuscate domains in your MRF descriptions
	- automatic translation of statuses via DeepL or LibreTranslate
	- ability to edit posts
	- ability to react with remote emoji

	### Changed
	- MFM parsing is now done on the backend by a modified version of ilja's parser -> https://akkoma.dev/AkkomaGang/mfm-parser
	- InlineQuotePolicy is now on by default
	- Enable remote users to interact with posts

	### Fixed
	- Compatibility with latest meilisearch
	- Resolution of nested mix tasks (i.e search.meilisearch) in OTP releases
	- Elasticsearch returning likes and repeats, displaying as posts
	- Ensure key generation happens at registration-time to prevent potential race-conditions
	- Ensured websockets get closed on logout
	- Allowed GoToSocial-style `?query_string` signatures

	### Removed
	- Non-finch HTTP adapters. `:tesla, :adapter` is now highly recommended to be set to the default.

	## 2022.08

	### Added
	- extended runtime module support, see config cheatsheet
	- quote posting; quotes are limited to public posts

	### Changed
	- quarantining is now considered absolutely; public activities are no longer
	an exception.
	- also merged quarantine and mrf reject - quarantine is now deprecated
	- flavours:
	- amd64 is built for debian stable. Compatible with ubuntu 20.
	- ubuntu-jammy is built for... well, ubuntu 22 (LTS)
	- amd64-musl is built for alpine 3.16

	### Fixed
	- Updated mastoFE path, for the newer version

	### Removed
	- Scrobbling support
	- `/api/v1/pleroma/scrobble`
	- `/api/v1/pleroma/accounts/{id}/scrobbles`
	- Deprecated endpoints
	- `/api/v1/pleroma/chats`
	- `/api/v1/notifications/dismiss`
	- `/api/v1/search`
	- `/api/v1/statuses/{id}/card`
	- Chats, they were half-baked. Just use PMs.
	- Prometheus, it causes massive slowdown

	## 2022.07

	### Added
	- Added move account API
	- Added ability to set instance accent-color via theme-color
	- A fallback page for when a user does not have a frontend installed
	- Support for OTP musl11

	### Removed
	- SSH frontend, to be potentially re-enabled via a bridge rather than wired into the main system
	- Gopher frontend, as above
	- All pre-compiled javascript

	### Fixed
	- ES8 support for bulk indexing activities

	### Upgrade Notes
	- The bundled frontend has been removed, you will need to run the `pleroma.frontend install` mix task to install your frontend of choice. Configuration by default is set to `pleroma-fe`.
	- Admin-FE users will have to ensure that :admin is set _BEFORE_ restart, or
	you might end up in a situation where you don't have an ability to get it.

	## 2.5.2

	### Added
	- Allow posting and recieving of misskey markdown (requires text/x.misskeymarkdown in `allowed_post_formats`)

	### Changed
	- Set frontend URLs to akkoma-maintained ones

	### Fixed
	- Updated `no_empty` MRF to not error when recieving misskey markdown

	### Security
	- Ensure local-only statuses do not get leaked

	## 2.5.1

	### Added
	- Elasticsearch Search provider support
	- Enabled custom emoji reactions to posts via `/api/v1/pleroma/statuses/:id/reactions/:shortcode:`
	- Added continuous integration builds for x86 glibc and musl

	### Fixed
	- Enabled support for non-standard AP entities, such as those used by bookwyrm

	## 2.5.0 - 10/06/2022

	### Changed
	- Allow users to remove their emails if instance does not need email to register

	### Added
	- `activeMonth` and `activeHalfyear` fields in NodeInfo usage.users object
	- Experimental support for Finch. Put `config :tesla, :adapter, {Tesla.Adapter.Finch, name: MyFinch}` in your secrets file to use it. Reverse Proxy will still use Hackney.
	- AdminAPI: allow moderators to manage reports, users, invites, and custom emojis
	- AdminAPI: restrict moderators to access sensitive data: change user credentials, get password reset token, read private statuses and chats, etc
	- PleromaAPI: Add remote follow API endpoint at `POST /api/v1/pleroma/remote_interaction`
	- MastoAPI: Add `GET /api/v1/accounts/lookup`
	- MastoAPI: Profile Directory support
	- MastoAPI: Support v2 Suggestions (handpicked accounts only)
	- Ability to log slow Ecto queries by configuring `:pleroma, :telemetry, :slow_queries_logging`
	- Added Phoenix LiveDashboard at `/phoenix/live_dashboard`
	- Added `/manifest.json` for progressive web apps.
	- Readded mastoFE
	- Added support for custom emoji reactions
	- Added `emoji_url` in notifications to allow for custom emoji rendering
	- Make backend-rendered pages translatable. This includes emails. Pages returned as a HTTP response are translated using the language specified in the `userLanguage` cookie, or the `Accept-Language` header. Emails are translated using the `language` field when registering. This language can be changed by `PATCH /api/v1/accounts/update_credentials` with the `language` field.

	### Fixed
	- Subscription(Bell) Notifications: Don't create from Pipeline Ingested replies
	- Handle Reject for already-accepted Follows properly
	- Display OpenGraph data on alternative notice routes.
	- Fix replies count for remote replies
	- ChatAPI: Add link headers
	- Limited number of search results to 40 to prevent DoS attacks
	- ActivityPub: fixed federation of attachment dimensions
	- Fixed benchmarks
	- Elixir 1.13 support
	- Fixed crash when pinned_objects is nil
	- Fixed slow timelines when there are a lot of deactivated users
	- Fixed account deletion API

	### Removed

	### Security
	- Private `/objects/` and `/activities/` leaking if cached by authenticated user
	- SweetXML library DTD bomb

	## 2.4.2 - 2022-01-10

	### Fixed
	- Federation issues caused by HTTP pool checkout timeouts
	- Compatibility with Elixir 1.13

	### Upgrade notes

	1. Restart Pleroma

	### Changed
	- Make `mix pleroma.database set_text_search_config` run concurrently and indefinitely

	### Added
	- AdminAPI: Missing configuration description for StealEmojiPolicy

	### Fixed
	- MastodonAPI: Stream out Create activities
	- MRF ObjectAgePolicy: Fix pattern matching on "published"
	- TwitterAPI: Make `change_password` and `change_email` require params on body instead of query
	- Subscription(Bell) Notifications: Don't create from Pipeline Ingested replies
	- AdminAPI: Fix rendering reports containing a `nil` object
	- Mastodon API: Activity Search fallbacks on status fetching after a DB Timeout/Error
	- Mastodon API: Fix crash in Streamer related to reblogging
	- AdminAPI: List available frontends when `static/frontends` folder is missing
	- Make activity search properly use language-aware GIN indexes
	- AdminAPI: Fix suggestions for MRF Policies

	## 2.4.0 - 2021-08-08

	### Changed

	- Breaking: Configuration: `:chat, enabled` moved to `:shout, enabled` and `:instance, chat_limit` moved to `:shout, limit`
	- Breaking Entries for simple_policy, transparency_exclusions and quarantined_instances now list both the instance and a reason.
	- Support for Erlang/OTP 24
	- The `application` metadata returned with statuses is no longer hardcoded. Apps that want to display these details will now have valid data for new posts after this change.
	- HTTPSecurityPlug now sends a response header to opt out of Google's FLoC (Federated Learning of Cohorts) targeted advertising.
	- Email address is now returned if requesting user is the owner of the user account so it can be exposed in client and FE user settings UIs.
	- Improved Twittercard and OpenGraph meta tag generation including thumbnails and image dimension metadata when available.
	- AdminAPI: sort users so the newest are at the top.
	- ActivityPub Client-to-Server(C2S): Limitation on the type of Activity/Object are lifted as they are now passed through ObjectValidators
	- MRF (`AntiFollowbotPolicy`): Bot accounts are now also considered followbots. Users can still allow bots to follow them by first following the bot.

	### Added

	- MRF (`FollowBotPolicy`): New MRF Policy which makes a designated local Bot account attempt to follow all users in public Notes received by your instance. Users who require approving follower requests or have #nobot in their profile are excluded.
	- Return OAuth token `id` (primary key) in POST `/oauth/token`.
	- AdminAPI: return `created_at` date with users.
	- AdminAPI: add DELETE `/api/v1/pleroma/admin/instances/:instance` to delete all content from a remote instance.
	- `AnalyzeMetadata` upload filter for extracting image/video attachment dimensions and generating blurhashes for images. Blurhashes for videos are not generated at this time.
	- Attachment dimensions and blurhashes are federated when available.
	- Mastodon API: support `poll` notification.
	- Pinned posts federation
	- Possibility to discover users like `user@example.org`, while Akkoma is working on `akkoma.example.org`. Additional configuration required.

	### Fixed
	- Don't crash so hard when email settings are invalid.
	- Checking activated Upload Filters for required commands.
	- Remote users can no longer reappear after being deleted.
	- Deactivated users may now be deleted.
	- Deleting an activity with a lot of likes/boosts no longer causes a database timeout.
	- Mix task `pleroma.database prune_objects`
	- Fixed rendering of JSON errors on ActivityPub endpoints.
	- Linkify: Parsing crash with URLs ending in unbalanced closed paren, no path separator, and no query parameters
	- Try to save exported ConfigDB settings (migrate_from_db) in the system temp directory if default location is not writable.
	- Uploading custom instance thumbnail via AdminAPI/AdminFE generated invalid URL to the image
	- Applying ConcurrentLimiter settings via AdminAPI
	- User login failures if their `notification_settings` were in a NULL state.
	- Mix task `pleroma.user delete_activities` query transaction timeout is now :infinity
	- MRF (`SimplePolicy`): Embedded objects are now checked. If any embedded object would be rejected, its parent is rejected. This fixes Announces leaking posts from blocked domains.
	- Fixed some Markdown issues, including trailing slash in links.

	### Removed
	- Breaking: Remove deprecated `/api/qvitter/statuses/notifications/read` (replaced by `/api/v1/pleroma/notifications/read`)

	## [2.3.0] - 2021-03-01

	### Security

	- Fixed client user agent leaking through MediaProxy

	### Removed

	- `:auth, :enforce_oauth_admin_scope_usage` configuration option.

	### Changed

	- Breaking: Changed `mix pleroma.user toggle_confirmed` to `mix pleroma.user confirm`
	- Breaking: Changed `mix pleroma.user toggle_activated` to `mix pleroma.user activate/deactivate`
	- Breaking: NSFW hashtag is no longer added on sensitive posts
	- Polls now always return a `voters_count`, even if they are single-choice.
	- Admin Emails: The ap id is used as the user link in emails now.
	- Improved registration workflow for email confirmation and account approval modes.
	- Search: When using Postgres 11+, Pleroma will use the `websearch_to_tsvector` function to parse search queries.
	- Emoji: Support the full Unicode 13.1 set of Emoji for reactions, plus regional indicators.
	- Deprecated `Pleroma.Uploaders.S3, :public_endpoint`. Now `Pleroma.Upload, :base_url` is the standard configuration key for all uploaders.
	- Improved Apache webserver support: updated sample configuration, MediaProxy cache invalidation verified with the included sample script
	- Improve OAuth 2.0 provider support. A missing `fqn` field was added to the response, but does not expose the user's email address.
	- Provide redirect of external posts from `/notice/:id` to their original URL
	- Admins no longer receive notifications for reports if they are the actor making the report.
	- Improved Mailer configuration setting descriptions for AdminFE.
	- Updated default avatar to look nicer.

	<details>
	<summary>API Changes</summary>

	- Breaking: AdminAPI changed User field `confirmation_pending` to `is_confirmed`
	- Breaking: AdminAPI changed User field `approval_pending` to `is_approved`
	- Breaking: AdminAPI changed User field `deactivated` to `is_active`
	- Breaking: AdminAPI `GET /api/pleroma/admin/users/:nickname_or_id/statuses` changed response format and added the number of total users posts.
	- Breaking: AdminAPI `GET /api/pleroma/admin/instances/:instance/statuses` changed response format and added the number of total users posts.
	- Admin API: Reports now ordered by newest
	- Pleroma API: `GET /api/v1/pleroma/chats` is deprecated in favor of `GET /api/v2/pleroma/chats`.
	- Pleroma API: Reroute `/api/pleroma/` to `/api/v1/pleroma/`

	</details>
	- Improved hashtag timeline performance (requires a background migration).

	### Added

	- Reports now generate notifications for admins and mods.
	- Support for local-only statuses.
	- Support pagination of blocks and mutes.
	- Account backup.
	- Configuration: Add `:instance, autofollowing_nicknames` setting to provide a way to make accounts automatically follow new users that register on the local Pleroma instance.
	- `[:activitypub, :blockers_visible]` config to control visibility of blockers.
	- Ability to view remote timelines, with ex. `/api/v1/timelines/public?instance=lain.com` and streams `public:remote` and `public:remote:media`.
	- The site title is now injected as a `title` tag like preloads or metadata.
	- Password reset tokens now are not accepted after a certain age.
	- Mix tasks to help with displaying and removing ConfigDB entries. See `mix pleroma.config`.
	- OAuth form improvements: users are remembered by their cookie, the CSS is overridable by the admin, and the style has been improved.
	- OAuth improvements and fixes: more secure session-based authentication (by token that could be revoked anytime), ability to revoke belonging OAuth token from any client etc.
	- Ability to set ActivityPub aliases for follower migration.
	- Configurable background job limits for RichMedia (link previews) and MediaProxyWarmingPolicy
	- Ability to define custom HTTP headers per each frontend
	- MRF (`NoEmptyPolicy`): New MRF Policy which will deny empty statuses or statuses of only mentions from being created by local users
	- New users will receive a simple email confirming their registration if no other emails will be dispatched. (e.g., Welcome, Confirmation, or Approval Required)

	<details>
	<summary>API Changes</summary>
	- Admin API: (`GET /api/pleroma/admin/users`) filter users by `unconfirmed` status and `actor_type`.
	- Admin API: OpenAPI spec for the user-related operations
	- Pleroma API: `GET /api/v2/pleroma/chats` added. It is exactly like `GET /api/v1/pleroma/chats` except supports pagination.
	- Pleroma API: Add `idempotency_key` to the chat message entity that can be used for optimistic message sending.
	- Pleroma API: (`GET /api/v1/pleroma/federation_status`) Add a way to get a list of unreachable instances.
	- Mastodon API: User and conversation mutes can now auto-expire if `expires_in` parameter was given while adding the mute.
	- Admin API: An endpoint to manage frontends.
	- Streaming API: Add follow relationships updates.
	- WebPush: Introduce `pleroma:chat_mention` and `pleroma:emoji_reaction` notification types.
	- Mastodon API: Add monthly active users to `/api/v1/instance` (`pleroma.stats.mau`).
	- Mastodon API: Home, public, hashtag & list timelines accept `only_media`, `remote` & `local` parameters for filtration.
	- Mastodon API: `/api/v1/accounts/:id` & `/api/v1/mutes` endpoints accept `with_relationships` parameter and return filled `pleroma.relationship` field.
	- Mastodon API: Endpoint to remove a conversation (`DELETE /api/v1/conversations/:id`).
	- Mastodon API: `expires_in` in the scheduled post `params` field on `/api/v1/statuses` and `/api/v1/scheduled_statuses/:id` endpoints.
	</details>

	### Fixed

	- Users with `is_discoverable` field set to false (default value) will appear in in-service search results but be hidden from external services (search bots etc.).
	- Streaming API: Posts and notifications are not dropped, when CLI task is executing.
	- Creating incorrect IPv4 address-style HTTP links when encountering certain numbers.
	- Reblog API Endpoint: Do not set visibility parameter to public by default and let CommonAPI to infer it from status, so a user can reblog their private status without explicitly setting reblog visibility to private.
	- Tag URLs in statuses are now absolute
	- Removed duplicate jobs to purge expired activities
	- File extensions of some attachments were incorrectly changed. This feature has been disabled for now.
	- Mix task pleroma.instance creates missing parent directories if the configuration or SQL output paths are changed.

	<details>
	<summary>API Changes</summary>
	- Mastodon API: Current user is now included in conversation if it's the only participant.
	- Mastodon API: Fixed last_status.account being not filled with account data.
	- Mastodon API: Fix not being able to add or remove multiple users at once in lists.
	- Mastodon API: Fixed own_votes being not returned with poll data.
	- Mastodon API: Fixed creation of scheduled posts with polls.
	- Mastodon API: Support for expires_in/expires_at in the Filters.
	</details>

	## [2.2.2] - 2021-01-18

	### Fixed

	- StealEmojiPolicy creates dir for emojis, if it doesn't exist.
	- Updated `elixir_make` to a non-retired version

	### Upgrade notes

	1. Restart Pleroma

	## [2.2.1] - 2020-12-22

	### Changed
	- Updated Pleroma FE

	### Fixed

	- Config generation: rename `Pleroma.Upload.Filter.ExifTool` to `Pleroma.Upload.Filter.Exiftool`.
	- S3 Uploads with Elixir 1.11.
	- Mix task pleroma.user delete_activities for source installations.
	- Search: RUM index search speed has been fixed.
	- Rich Media Previews sometimes showed the wrong preview due to a bug following redirects.
	- Fixes for the autolinker.
	- Forwarded reports duplication from Pleroma instances.
	- Emoji Reaction activity filtering from blocked and muted accounts.

	- <details>
	<summary>API</summary>
	- Statuses were not displayed for Mastodon forwarded reports.
	</details>

	### Upgrade notes

	1. Restart Pleroma

	## [2.2.0] - 2020-11-12

	### Security

	- Fixed the possibility of using file uploads to spoof posts.

	### Changed

	- Breaking Requires `libmagic` (or `file`) to guess file types.
	- Breaking: App metrics endpoint (`/api/pleroma/app_metrics`) is disabled by default, check `docs/API/prometheus.md` on enabling and configuring.
	- Breaking: Pleroma Admin API: emoji packs and files routes changed.
	- Breaking: Sensitive/NSFW statuses no longer disable link previews.
	- Search: Users are now findable by their urls.
	- Renamed `:await_up_timeout` in `:connections_pool` namespace to `:connect_timeout`, old name is deprecated.
	- Renamed `:timeout` in `pools` namespace to `:recv_timeout`, old name is deprecated.
	- The `discoverable` field in the `User` struct will now add a NOINDEX metatag to profile pages when false.
	- Users with the `is_discoverable` field set to false will not show up in searches ([bug](https://git.pleroma.social/pleroma/pleroma/-/issues/2301)).
	- Minimum lifetime for ephmeral activities changed to 10 minutes and made configurable (`:min_lifetime` option).
	- Introduced optional dependencies on `ffmpeg`, `ImageMagick`, `exiftool` software packages. Please refer to `docs/installation/optional/media_graphics_packages.md`.
	- <details>
	<summary>API Changes</summary>
	- API: Empty parameter values for integer parameters are now ignored in non-strict validaton mode.
	</details>

	### Removed

	- Breaking: `Pleroma.Workers.Cron.StatsWorker` setting from Oban `:crontab` (moved to a simpler implementation).
	- Breaking: `Pleroma.Workers.Cron.ClearOauthTokenWorker` setting from Oban `:crontab` (moved to scheduled jobs).
	- Breaking: `Pleroma.Workers.Cron.PurgeExpiredActivitiesWorker` setting from Oban `:crontab` (moved to scheduled jobs).
	- Removed `:managed_config` option. In practice, it was accidentally removed with 2.0.0 release when frontends were
	switched to a new configuration mechanism, however it was not officially removed until now.

	### Added

	- Media preview proxy (requires `ffmpeg` and `ImageMagick` to be installed and media proxy to be enabled; see `:media_preview_proxy` config for more details).
	- Mix tasks for controlling user account confirmation status in bulk (`mix pleroma.user confirm_all` and `mix pleroma.user unconfirm_all`)
	- Mix task for sending confirmation emails to all unconfirmed users (`mix pleroma.email resend_confirmation_emails`)
	- Mix task option for force-unfollowing relays
	- App metrics: ability to restrict access to specified IP whitelist.

	<details>
	<summary>API Changes</summary>

	- Admin API: Importing emoji from a zip file
	- Pleroma API: Importing the mutes users from CSV files.
	- Pleroma API: Pagination for remote/local packs and emoji.

	</details>

	### Fixed

	- Add documented-but-missing chat pagination.
	- Allow sending out emails again.
	- Allow sending chat messages to yourself
	- OStatus / static FE endpoints: fixed inaccessibility for anonymous users on non-federating instances, switched to handling per `:restrict_unauthenticated` setting.
	- Fix remote users with a whitespace name.

	### Upgrade notes

	1. Install libmagic and development headers (`libmagic-dev` on Ubuntu/Debian, `file-dev` on Alpine Linux)
	2. Run database migrations (inside Pleroma directory):
	- OTP: `./bin/pleroma_ctl migrate`
	- From Source: `mix ecto.migrate`
	3. Restart Pleroma

	## [2.1.2] - 2020-09-17

	### Security

	- Fix most MRF rules either crashing or not being applied to objects passed into the Common Pipeline (ChatMessage, Question, Answer, Audio, Event).

	### Fixed

	- Welcome Chat messages preventing user registration with MRF Simple Policy applied to the local instance.
	- Mastodon API: the public timeline returning an error when the `reply_visibility` parameter is set to `self` for an unauthenticated user.
	- Mastodon Streaming API: Handler crashes on authentication failures, resulting in error logs.
	- Mastodon Streaming API: Error logs on client pings.
	- Rich media: Log spam on failures. Now the error is only logged once per attempt.

	### Changed

	- Rich Media: A HEAD request is now done to the url, to ensure it has the appropriate content type and size before proceeding with a GET.

	### Upgrade notes

	1. Restart Pleroma

	## [2.1.1] - 2020-09-08

	### Security
	- Fix possible DoS in Mastodon API user search due to an error in match clauses, leading to an infinite recursion and subsequent OOM with certain inputs.
	- Fix metadata leak for accounts and statuses on private instances.
	- Fix possible DoS in Admin API search using an atom leak vulnerability. Authentication with admin rights was required to exploit.

	### Changed

	- Breaking: The metadata providers RelMe and Feed are no longer configurable. RelMe should always be activated and Feed only provides a <link> header tag for the actual RSS/Atom feed when the instance is public.
	- Improved error message when cmake is not available at build stage.

	### Added
	- Rich media failure tracking (along with `:failure_backoff` option).

	<details>
	<summary>Admin API Changes</summary>

	- Add `PATCH /api/pleroma/admin/instance_document/:document_name` to modify the Terms of Service and Instance Panel HTML pages via Admin API
	</details>

	### Fixed
	- Default HTTP adapter not respecting pool setting, leading to possible OOM.
	- Fixed uploading webp images when the Exiftool Upload Filter is enabled by skipping them
	- Mastodon API: Search parameter `following` now correctly returns the followings rather than the followers
	- Mastodon API: Timelines hanging for (`number of posts with links * rich media timeout`) in the worst case.
	Reduced to just rich media timeout.
	- Mastodon API: Cards being wrong for preview statuses due to cache key collision.
	- Password resets no longer processed for deactivated accounts.
	- Favicon scraper raising exceptions on URLs longer than 255 characters.

	## [2.1.0] - 2020-08-28

	### Changed

	- Breaking: The default descriptions on uploads are now empty. The old behavior (filename as default) can be configured, see the cheat sheet.
	- Breaking: Added the ObjectAgePolicy to the default set of MRFs. This will delist and strip the follower collection of any message received that is older than 7 days. This will stop users from seeing very old messages in the timelines. The messages can still be viewed on the user's page and in conversations. They also still trigger notifications.
	- Breaking: Elixir >=1.9 is now required (was >= 1.8)
	- Breaking: Configuration: `:auto_linker, :opts` moved to `:pleroma, Pleroma.Formatter`. Old config namespace is deprecated.
	- Breaking: Configuration: `:instance, welcome_user_nickname` moved to `:welcome, :direct_message, :sender_nickname`, `:instance, :welcome_message` moved to `:welcome, :direct_message, :message`. Old config namespace is deprecated.
	- Breaking: LDAP: Fallback to local database authentication has been removed for security reasons and lack of a mechanism to ensure the passwords are synchronized when LDAP passwords are updated.
	- Breaking Changed defaults for `:restrict_unauthenticated` so that when `:instance, :public` is set to `false` then all `:restrict_unauthenticated` items be effectively set to `true`. If you'd like to allow unauthenticated access to specific API endpoints on a private instance, please explicitly set `:restrict_unauthenticated` to non-default value in `config/prod.secret.exs`.
	- In Conversations, return only direct messages as `last_status`
	- Using the `only_media` filter on timelines will now exclude reblog media
	- MFR policy to set global expiration for all local Create activities
	- OGP rich media parser merged with TwitterCard
	- Configuration: `:instance, rewrite_policy` moved to `:mrf, policies`, `:instance, :mrf_transparency` moved to `:mrf, :transparency`, `:instance, :mrf_transparency_exclusions` moved to `:mrf, :transparency_exclusions`. Old config namespace is deprecated.
	- Configuration: `:media_proxy, whitelist` format changed to host with scheme (e.g. `http://example.com` instead of `example.com`). Domain format is deprecated.

	<details>
	<summary>API Changes</summary>

	- Breaking: Pleroma API: The routes to update avatar, banner and background have been removed.
	- Breaking: Image description length is limited now.
	- Breaking: Emoji API: changed methods and renamed routes.
	- Breaking: Notification Settings API for suppressing notifications has been simplified down to `block_from_strangers`.
	- Breaking: Notification Settings API option for hiding push notification contents has been renamed to `hide_notification_contents`.
	- MastodonAPI: Allow removal of avatar, banner and background.
	- Streaming: Repeats of a user's posts will no longer be pushed to the user's stream.
	- Mastodon API: Added `pleroma.metadata.fields_limits` to /api/v1/instance
	- Mastodon API: On deletion, returns the original post text.
	- Mastodon API: Add `pleroma.unread_count` to the Marker entity.
	- Mastodon API: Added `pleroma.metadata.post_formats` to /api/v1/instance
	- Mastodon API (legacy): Allow query parameters for `/api/v1/domain_blocks`, e.g. `/api/v1/domain_blocks?domain=badposters.zone`
	- Mastodon API: Make notifications about statuses from muted users and threads read automatically
	- Pleroma API: `/api/pleroma/captcha` responses now include `seconds_valid` with an integer value.

	</details>

	<details>
	<summary>Admin API Changes</summary>

	- Breaking Changed relay `/api/pleroma/admin/relay` endpoints response format.
	- Status visibility stats: now can return stats per instance.
	- Mix task to refresh counter cache (`mix pleroma.refresh_counter_cache`)

	</details>

	### Removed

	- Breaking: removed `with_move` parameter from notifications timeline.

	### Added

	- Frontends: Add mix task to install frontends.
	- Frontends: Add configurable frontends for primary and admin fe.
	- Configuration: Added a blacklist for email servers.
	- Chats: Added `accepts_chat_messages` field to user, exposed in APIs and federation.
	- Chats: Added support for federated chats. For details, see the docs.
	- ActivityPub: Added support for existing AP ids for instances migrated from Mastodon.
	- Instance: Add `background_image` to configuration and `/api/v1/instance`
	- Instance: Extend `/api/v1/instance` with Pleroma-specific information.
	- NodeInfo: `pleroma:api/v1/notifications:include_types_filter` to the `features` list.
	- NodeInfo: `pleroma_emoji_reactions` to the `features` list.
	- Configuration: `:restrict_unauthenticated` setting, restrict access for unauthenticated users to timelines (public and federate), user profiles and statuses.
	- Configuration: Add `:database_config_whitelist` setting to whitelist settings which can be configured from AdminFE.
	- Configuration: `filename_display_max_length` option to set filename truncate limit, if filename display enabled (0 = no limit).
	- New HTTP adapter [gun](https://github.com/ninenines/gun). Gun adapter requires minimum OTP version of 22.2 otherwise Pleroma won’t start. For hackney OTP update is not required.
	- Mix task to create trusted OAuth App.
	- Mix task to reset MFA for user accounts
	- Notifications: Added `follow_request` notification type.
	- Added `:reject_deletes` group to SimplePolicy
	- MRF (`EmojiStealPolicy`): New MRF Policy which allows to automatically download emojis from remote instances
	- Support pagination in emoji packs API (for packs and for files in pack)
	- Support for viewing instances favicons next to posts and accounts
	- Added Pleroma.Upload.Filter.Exiftool as an alternate EXIF stripping mechanism targeting GPS/location metadata.
	- "By approval" registrations mode.
	- Configuration: Added `:welcome` settings for the welcome message to newly registered users. You can send a welcome message as a direct message, chat or email.
	- Ability to hide favourites and emoji reactions in the API with `[:instance, :show_reactions]` config.

	<details>
	<summary>API Changes</summary>

	- Mastodon API: Add pleroma.parent_visible field to statuses.
	- Mastodon API: Extended `/api/v1/instance`.
	- Mastodon API: Support for `include_types` in `/api/v1/notifications`.
	- Mastodon API: Added `/api/v1/notifications/:id/dismiss` endpoint.
	- Mastodon API: Add support for filtering replies in public and home timelines.
	- Mastodon API: Support for `bot` field in `/api/v1/accounts/update_credentials`.
	- Mastodon API: Support irreversible property for filters.
	- Mastodon API: Add pleroma.favicon field to accounts.
	- Admin API: endpoints for create/update/delete OAuth Apps.
	- Admin API: endpoint for status view.
	- OTP: Add command to reload emoji packs
	</details>

	### Fixed
	- Fix list pagination and other list issues.
	- Support pagination in conversations API
	- Breaking: SimplePolicy `:reject` and `:accept` allow deletions again
	- Fix follower/blocks import when nicknames starts with @
	- Filtering of push notifications on activities from blocked domains
	- Resolving Peertube accounts with Webfinger
	- `blob:` urls not being allowed by connect-src CSP
	- Mastodon API: fix `GET /api/v1/notifications` not returning the full result set
	- Rich Media Previews for Twitter links
	- Admin API: fix `GET /api/pleroma/admin/users/:nickname/credentials` returning 404 when getting the credentials of a remote user while `:instance, :limit_to_local_content` is set to `:unauthenticated`
	- Fix CSP policy generation to include remote Captcha services
	- Fix edge case where MediaProxy truncates media, usually caused when Caddy is serving content for the other Federated instance.
	- Emoji Packs could not be listed when instance was set to `public: false`
	- Fix whole_word always returning false on filter get requests
	- Migrations not working on OTP releases if the database was connected over ssl
	- Fix relay following

	## [2.0.7] - 2020-06-13

	### Security
	- Fix potential DoSes exploiting atom leaks in rich media parser and the `UserAllowListPolicy` MRF policy

	### Fixed
	- CSP: not allowing images/media from every host when mediaproxy is disabled
	- CSP: not adding mediaproxy base url to image/media hosts
	- StaticFE missing the CSS file

	### Upgrade notes

	1. Restart Pleroma

	## [2.0.6] - 2020-06-09

	### Security
	- CSP: harden `image-src` and `media-src` when MediaProxy is used

	### Fixed
	- AP C2S: Fix pagination in inbox/outbox
	- Various compilation errors on OTP 23
	- Mastodon API streaming: Repeats from muted threads not being filtered

	### Changed
	- Various database performance improvements

	### Upgrade notes
	1. Run database migrations (inside Pleroma directory):
	- OTP: `./bin/pleroma_ctl migrate`
	- From Source: `mix ecto.migrate`
	2. Restart Pleroma

	## [2.0.5] - 2020-05-13

	### Security
	- Fix possible private status leaks in Mastodon Streaming API

	### Fixed
	- Crashes when trying to block a user if block federation is disabled
	- Not being able to start the instance without `erlang-eldap` installed
	- Users with bios over the limit getting rejected
	- Follower counters not being updated on incoming follow accepts

	### Upgrade notes

	1. Restart Pleroma

	## [2.0.4] - 2020-05-10

	### Security
	- AP C2S: Fix a potential DoS by creating nonsensical objects that break timelines

	### Fixed
	- Peertube user lookups not working
	- `InsertSkeletonsForDeletedUsers` migration failing on some instances
	- Healthcheck reporting the number of memory currently used, rather than allocated in total
	- LDAP not being usable in OTP releases
	- Default apache configuration having tls chain issues

	### Upgrade notes

	#### Apache only

	1. Remove the following line from your config:
	```
	SSLCertificateFile /etc/letsencrypt/live/${servername}/cert.pem
	```

	#### Everyone

	1. Restart Pleroma

	## [2.0.3] - 2020-05-02

	### Security
	- Disallow re-registration of previously deleted users, which allowed viewing direct messages addressed to them
	- Mastodon API: Fix `POST /api/v1/follow_requests/:id/authorize` allowing to force a follow from a local user even if they didn't request to follow
	- CSP: Sandbox uploads

	### Fixed
	- Notifications from blocked domains
	- Potential federation issues with Mastodon versions before 3.0.0
	- HTTP Basic Authentication permissions issue
	- Follow/Block imports not being able to find the user if the nickname started with an `@`
	- Instance stats counting internal users
	- Inability to run a From Source release without git
	- ObjectAgePolicy didn't filter out old messages
	- `blob:` urls not being allowed by CSP

	### Added
	- NodeInfo: ObjectAgePolicy settings to the `federation` list.
	- Follow request notifications
	<details>
	<summary>API Changes</summary>
	- Admin API: `GET /api/pleroma/admin/need_reboot`.
	</details>

	### Upgrade notes

	1. Restart Pleroma
	2. Run database migrations (inside Pleroma directory):
	- OTP: `./bin/pleroma_ctl migrate`
	- From Source: `mix ecto.migrate`
	3. Reset status visibility counters (inside Pleroma directory):
	- OTP: `./bin/pleroma_ctl refresh_counter_cache`
	- From Source: `mix pleroma.refresh_counter_cache`


	## [2.0.2] - 2020-04-08
	### Added
	- Support for Funkwhale's `Audio` activity
	- Admin API: `PATCH /api/pleroma/admin/users/:nickname/update_credentials`

	### Fixed
	- Blocked/muted users still generating push notifications
	- Input textbox for bio ignoring newlines
	- OTP: Inability to use PostgreSQL databases with SSL
	- `user delete_activities` breaking when trying to delete already deleted posts
	- Incorrect URL for Funkwhale channels

	### Upgrade notes
	1. Restart Pleroma

	## [2.0.1] - 2020-03-15
	### Security
	- Static-FE: Fix remote posts not being sanitized

	### Fixed
	- Rate limiter crashes when there is no explicitly specified ip in the config
	- 500 errors when no `Accept` header is present if Static-FE is enabled
	- Instance panel not being updated immediately due to wrong `Cache-Control` headers
	- Statuses posted with BBCode/Markdown having unncessary newlines in Pleroma-FE
	- OTP: Fix some settings not being migrated to in-database config properly
	- No `Cache-Control` headers on attachment/media proxy requests
	- Character limit enforcement being off by 1
	- Mastodon Streaming API: hashtag timelines not working

	### Changed
	- BBCode and Markdown formatters will no longer return any `\n` and only use `<br/>` for newlines
	- Mastodon API: Allow registration without email if email verification is not enabled

	### Upgrade notes
	#### Nginx only
	1. Remove `proxy_ignore_headers Cache-Control;` and `proxy_hide_header Cache-Control;` from your config.

	#### Everyone
	1. Run database migrations (inside Pleroma directory):
	- OTP: `./bin/pleroma_ctl migrate`
	- From Source: `mix ecto.migrate`
	2. Restart Pleroma

	## [2.0.0] - 2019-03-08
	### Security
	- Mastodon API: Fix being able to request enormous amount of statuses in timelines leading to DoS. Now limited to 40 per request.

	### Removed
	- Breaking: Removed 1.0+ deprecated configurations `Pleroma.Upload, :strip_exif` and `:instance, :dedupe_media`
	- Breaking: OStatus protocol support
	- Breaking: MDII uploader
	- Breaking: Using third party engines for user recommendation
	<details>
	<summary>API Changes</summary>

	- Breaking: AdminAPI: migrate_from_db endpoint
	</details>

	### Changed
	- Breaking: Pleroma won't start if it detects unapplied migrations
	- Breaking: Elixir >=1.8 is now required (was >= 1.7)
	- Breaking: `Pleroma.Plugs.RemoteIp` and `:rate_limiter` enabled by default. Please ensure your reverse proxy forwards the real IP!
	- Breaking: attachment links (`config :pleroma, :instance, no_attachment_links` and `config :pleroma, Pleroma.Upload, link_name`) disabled by default
	- Breaking: OAuth: defaulted `[:auth, :enforce_oauth_admin_scope_usage]` setting to `true` which demands `admin` OAuth scope to perform admin actions (in addition to `is_admin` flag on User); make sure to use bundled or newer versions of AdminFE & PleromaFE to access admin / moderator features.
	- Breaking: Dynamic configuration has been rearchitected. The `:pleroma, :instance, dynamic_configuration` setting has been replaced with `config :pleroma, configurable_from_database`. Please backup your configuration to a file and run the migration task to ensure consistency with the new schema.
	- Breaking: `:instance, no_attachment_links` has been replaced with `:instance, attachment_links` which still takes a boolean value but doesn't use double negative language.
	- Replaced [pleroma_job_queue](https://git.pleroma.social/pleroma/pleroma_job_queue) and `Pleroma.Web.Federator.RetryQueue` with [Oban](https://github.com/sorentwo/oban) (see [`docs/config.md`](docs/config.md) on migrating customized worker / retry settings)
	- Introduced [quantum](https://github.com/quantum-elixir/quantum-core) job scheduler
	- Enabled `:instance, extended_nickname_format` in the default config
	- Add `rel="ugc"` to all links in statuses, to prevent SEO spam
	- Extract RSS functionality from OStatus
	- MRF (Simple Policy): Also use `:accept`/`:reject` on the actors rather than only their activities
	- OStatus: Extract RSS functionality
	- Deprecated `User.Info` embedded schema (fields moved to `User`)
	- Store status data inside Flag activity
	- Deprecated (reorganized as `UserRelationship` entity) User fields with user AP IDs (`blocks`, `mutes`, `muted_reblogs`, `muted_notifications`, `subscribers`).
	- Rate limiter is now disabled for localhost/socket (unless remoteip plug is enabled)
	- Logger: default log level changed from `warn` to `info`.
	- Config mix task `migrate_to_db` truncates `config` table before migrating the config file.
	- Allow account registration without an email
	- Default to `prepare: :unnamed` in the database configuration.
	- Instance stats are now loaded on startup instead of being empty until next hourly job.
	<details>
	<summary>API Changes</summary>

	- Breaking EmojiReactions: Change endpoints and responses to align with Mastodon
	- Breaking Admin API: `PATCH /api/pleroma/admin/users/:nickname/force_password_reset` is now `PATCH /api/pleroma/admin/users/force_password_reset` (accepts `nicknames` array in the request body)
	- Breaking: Admin API: Return link alongside with token on password reset
	- Breaking: Admin API: `PUT /api/pleroma/admin/reports/:id` is now `PATCH /api/pleroma/admin/reports`, see admin_api.md for details
	- Breaking: `/api/pleroma/admin/users/invite_token` now uses `POST`, changed accepted params and returns full invite in json instead of only token string.
	- Breaking replying to reports is now "report notes", endpoint changed from `POST /api/pleroma/admin/reports/:id/respond` to `POST /api/pleroma/admin/reports/:id/notes`
	- Mastodon API: stopped sanitizing display names, field names and subject fields since they are supposed to be treated as plaintext
	- Admin API: Return `total` when querying for reports
	- Mastodon API: Return `pleroma.direct_conversation_id` when creating a direct message (`POST /api/v1/statuses`)
	- Admin API: Return link alongside with token on password reset
	- Admin API: Support authentication via `x-admin-token` HTTP header
	- Mastodon API: Add `pleroma.direct_conversation_id` to the status endpoint (`GET /api/v1/statuses/:id`)
	- Mastodon API: `pleroma.thread_muted` to the Status entity
	- Mastodon API: Mark the direct conversation as read for the author when they send a new direct message
	- Mastodon API, streaming: Add `pleroma.direct_conversation_id` to the `conversation` stream event payload.
	- Admin API: Render whole status in grouped reports
	- Mastodon API: User timelines will now respect blocks, unless you are getting the user timeline of somebody you blocked (which would be empty otherwise).
	- Mastodon API: Favoriting / Repeating a post multiple times will now return the identical response every time. Before, executing that action twice would return an error ("already favorited") on the second try.
	- Mastodon API: Limit timeline requests to 3 per timeline per 500ms per user/ip by default.
	- Admin API: `PATCH /api/pleroma/admin/users/:nickname/credentials` and `GET /api/pleroma/admin/users/:nickname/credentials`
	</details>

	### Added
	- `:chat_limit` option to limit chat characters.
	- `cleanup_attachments` option to remove attachments along with statuses. Does not affect duplicate files and attachments without status. Enabling this will increase load to database when deleting statuses on larger instances.
	- Refreshing poll results for remote polls
	- Authentication: Added rate limit for password-authorized actions / login existence checks
	- Static Frontend: Add the ability to render user profiles and notices server-side without requiring JS app.
	- Mix task to re-count statuses for all users (`mix pleroma.count_statuses`)
	- Mix task to list all users (`mix pleroma.user list`)
	- Mix task to send a test email (`mix pleroma.email test`)
	- Support for `X-Forwarded-For` and similar HTTP headers which used by reverse proxies to pass a real user IP address to the backend. Must not be enabled unless your instance is behind at least one reverse proxy (such as Nginx, Apache HTTPD or Varnish Cache).
	- MRF: New module which handles incoming posts based on their age. By default, all incoming posts that are older than 2 days will be unlisted and not shown to their followers.
	- User notification settings: Add `privacy_option` option.
	- Support for custom Elixir modules (such as MRF policies)
	- User settings: Add _This account is a_ option.
	- A new users admin digest email
	- OAuth: admin scopes support (relevant setting: `[:auth, :enforce_oauth_admin_scope_usage]`).
	- Add an option `authorized_fetch_mode` to require HTTP signatures for AP fetches.
	- ActivityPub: support for `replies` collection (output for outgoing federation & fetching on incoming federation).
	- Mix task to refresh counter cache (`mix pleroma.refresh_counter_cache`)
	<details>
	<summary>API Changes</summary>

	- Job queue stats to the healthcheck page
	- Admin API: Add ability to fetch reports, grouped by status `GET /api/pleroma/admin/grouped_reports`
	- Admin API: Add ability to require password reset
	- Mastodon API: Account entities now include `follow_requests_count` (planned Mastodon 3.x addition)
	- Pleroma API: `GET /api/v1/pleroma/accounts/:id/scrobbles` to get a list of recently scrobbled items
	- Pleroma API: `POST /api/v1/pleroma/scrobble` to scrobble a media item
	- Mastodon API: Add `upload_limit`, `avatar_upload_limit`, `background_upload_limit`, and `banner_upload_limit` to `/api/v1/instance`
	- Mastodon API: Add `pleroma.unread_conversation_count` to the Account entity
	- OAuth: support for hierarchical permissions / [Mastodon 2.4.3 OAuth permissions](https://docs.joinmastodon.org/api/permissions/)
	- Metadata Link: Atom syndication Feed
	- Mix task to re-count statuses for all users (`mix pleroma.count_statuses`)
	- Mastodon API: Add `exclude_visibilities` parameter to the timeline and notification endpoints
	- Admin API: `/users/:nickname/toggle_activation` endpoint is now deprecated in favor of: `/users/activate`, `/users/deactivate`, both accept `nicknames` array
	- Admin API: Multiple endpoints now require `nicknames` array, instead of singe `nickname`:
	- `POST/DELETE /api/pleroma/admin/users/:nickname/permission_group/:permission_group` are deprecated in favor of: `POST/DELETE /api/pleroma/admin/users/permission_group/:permission_group`
	- `DELETE /api/pleroma/admin/users` (`nickname` query param or `nickname` sent in JSON body) is deprecated in favor of: `DELETE /api/pleroma/admin/users` (`nicknames` query array param or `nicknames` sent in JSON body)
	- Admin API: Add `GET /api/pleroma/admin/relay` endpoint - lists all followed relays
	- Pleroma API: `POST /api/v1/pleroma/conversations/read` to mark all conversations as read
	- ActivityPub: Support `Move` activities
	- Mastodon API: Add `/api/v1/markers` for managing timeline read markers
	- Mastodon API: Add the `recipients` parameter to `GET /api/v1/conversations`
	- Configuration: `feed` option for user atom feed.
	- Pleroma API: Add Emoji reactions
	- Admin API: Add `/api/pleroma/admin/instances/:instance/statuses` - lists all statuses from a given instance
	- Admin API: Add `/api/pleroma/admin/users/:nickname/statuses` - lists all statuses from a given user
	- Admin API: `PATCH /api/pleroma/users/confirm_email` to confirm email for multiple users, `PATCH /api/pleroma/users/resend_confirmation_email` to resend confirmation email for multiple users
	- ActivityPub: Configurable `type` field of the actors.
	- Mastodon API: `/api/v1/accounts/:id` has `source/pleroma/actor_type` field.
	- Mastodon API: `/api/v1/update_credentials` accepts `actor_type` field.
	- Captcha: Support native provider
	- Captcha: Enable by default
	- Mastodon API: Add support for `account_id` param to filter notifications by the account
	- Mastodon API: Add `emoji_reactions` property to Statuses
	- Mastodon API: Change emoji reaction reply format
	- Notifications: Added `pleroma:emoji_reaction` notification type
	- Mastodon API: Change emoji reaction reply format once more
	- Configuration: `feed.logo` option for tag feed.
	- Tag feed: `/tags/:tag.rss` - list public statuses by hashtag.
	- Mastodon API: Add `reacted` property to `emoji_reactions`
	- Pleroma API: Add reactions for a single emoji.
	- ActivityPub: `[:activitypub, :note_replies_output_limit]` setting sets the number of note self-replies to output on outgoing federation.
	- Admin API: `GET /api/pleroma/admin/stats` to get status count by visibility scope
	- Admin API: `GET /api/pleroma/admin/statuses` - list all statuses (accepts `godmode` and `local_only`)
	</details>

	### Fixed
	- Report emails now include functional links to profiles of remote user accounts
	- Not being able to log in to some third-party apps when logged in to MastoFE
	- MRF: `Delete` activities being exempt from MRF policies
	- OTP releases: Not being able to configure OAuth expired token cleanup interval
	- OTP releases: Not being able to configure HTML sanitization policy
	- OTP releases: Not being able to change upload limit (again)
	- Favorites timeline now ordered by favorite date instead of post date
	- Support for cancellation of a follow request
	<details>
	<summary>API Changes</summary>

	- Mastodon API: Fix private and direct statuses not being filtered out from the public timeline for an authenticated user (`GET /api/v1/timelines/public`)
	- Mastodon API: Inability to get some local users by nickname in `/api/v1/accounts/:id_or_nickname`
	- AdminAPI: If some status received reports both in the "new" format and "old" format it was considered reports on two different statuses (in the context of grouped reports)
	- Admin API: Error when trying to update reports in the "old" format
	- Mastodon API: Marking a conversation as read (`POST /api/v1/conversations/:id/read`) now no longer brings it to the top in the user's direct conversation list
	</details>

	## [1.1.9] - 2020-02-10
	### Fixed
	- OTP: Inability to set the upload limit (again)
	- Not being able to pin polls
	- Streaming API: incorrect handling of reblog mutes
	- Rejecting the user when field length limit is exceeded
	- OpenGraph provider: html entities in descriptions

	## [1.1.8] - 2020-01-10
	### Fixed
	- Captcha generation issues
	- Returned Kocaptcha endpoint to configuration
	- Captcha validity is now 5 minutes

	## [1.1.7] - 2019-12-13
	### Fixed
	- OTP: Inability to set the upload limit
	- OTP: Inability to override node name/distribution type to run 2 Pleroma instances on the same machine

	### Added
	- Integrated captcha provider

	### Changed
	- Captcha enabled by default
	- Default Captcha provider changed from `Pleroma.Captcha.Kocaptcha` to `Pleroma.Captcha.Native`
	- Better `Cache-Control` header for static content

	### Bundled Pleroma-FE Changes
	#### Added
	- Icons in the navigation panel

	#### Fixed
	- Improved support unauthenticated view of private instances

	#### Removed
	- Whitespace hack on empty post content

	## [1.1.6] - 2019-11-19
	### Fixed
	- Not being able to log into to third party apps when the browser is logged into mastofe
	- Email confirmation not being required even when enabled
	- Mastodon API: conversations API crashing when one status is malformed

	### Bundled Pleroma-FE Changes
	#### Added
	- About page
	- Meme arrows

	#### Fixed
	- Image modal not closing unless clicked outside of image
	- Attachment upload spinner not being centered
	- Showing follow counters being 0 when they are actually hidden

	## [1.1.5] - 2019-11-09
	### Fixed
	- Polls having different numbers in timelines/notifications/poll api endpoints due to cache desyncronization
	- Pleroma API: OAuth token endpoint not being found when ".json" suffix is appended

	### Changed
	- Frontend bundle updated to [044c9ad0](https://git.pleroma.social/pleroma/pleroma-fe/commit/044c9ad0562af059dd961d50961a3880fca9c642)

	## [1.1.4] - 2019-11-01
	### Fixed
	- Added a migration that fills up empty user.info fields to prevent breakage after previous unsafe migrations.
	- Failure to migrate from pre-1.0.0 versions
	- Mastodon API: Notification stream not including follow notifications

	## [1.1.3] - 2019-10-25
	### Fixed
	- Blocked users showing up in notifications collapsed as if they were muted
	- `pleroma_ctl` not working on Debian's default shell

	## [1.1.2] - 2019-10-18
	### Fixed
	- `pleroma_ctl` trying to connect to a running instance when generating the config, which of course doesn't exist.

	## [1.1.1] - 2019-10-18
	### Fixed
	- One of the migrations between 1.0.0 and 1.1.0 wiping user info of the relay user because of unexpected behavior of postgresql's `jsonb_set`, resulting in inability to post in the default configuration. If you were affected, please run the following query in postgres console, the relay user will be recreated automatically:
	```
	delete from users where ap_id = 'https://your.instance.hostname/relay';
	```
	- Bad user search matches

	## [1.1.0] - 2019-10-14
	Breaking: The stable branch has been changed from `master` to `stable`. If you want to keep using 1.0, the `release/1.0` branch will receive security updates for 6 months after 1.1 release.

	OTP Note: `pleroma_ctl` in 1.0 defaults to `master` and doesn't support specifying arbitrary branches, making `./pleroma_ctl update` fail. To fix this, fetch a version of `pleroma_ctl` from 1.1 using the command below and proceed with the update normally:
	```
	curl -Lo ./bin/pleroma_ctl 'https://git.pleroma.social/pleroma/pleroma/raw/develop/rel/files/bin/pleroma_ctl'
	```
	### Security
	- Mastodon API: respect post privacy in `/api/v1/statuses/:id/{favourited,reblogged}_by`

	### Removed
	- Breaking: GNU Social API with Qvitter extensions support
	- Emoji: Remove longfox emojis.
	- Remove `Reply-To` header from report emails for admins.
	- ActivityPub: The `/objects/:uuid/likes` endpoint.

	### Changed
	- Breaking: Configuration: A setting to explicitly disable the mailer was added, defaulting to true, if you are using a mailer add `config :pleroma, Pleroma.Emails.Mailer, enabled: true` to your config
	- Breaking: Configuration: `/media/` is now removed when `base_url` is configured, append `/media/` to your `base_url` config to keep the old behaviour if desired
	- Breaking: `/api/pleroma/notifications/read` is moved to `/api/v1/pleroma/notifications/read` and now supports `max_id` and responds with Mastodon API entities.
	- Configuration: added `config/description.exs`, from which `docs/config.md` is generated
	- Configuration: OpenGraph and TwitterCard providers enabled by default
	- Configuration: Filter.AnonymizeFilename added ability to retain file extension with custom text
	- Federation: Return 403 errors when trying to request pages from a user's follower/following collections if they have `hide_followers`/`hide_follows` set
	- NodeInfo: Return `skipThreadContainment` in `metadata` for the `skip_thread_containment` option
	- NodeInfo: Return `mailerEnabled` in `metadata`
	- Mastodon API: Unsubscribe followers when they unfollow a user
	- Mastodon API: `pleroma.thread_muted` key in the Status entity
	- AdminAPI: Add "godmode" while fetching user statuses (i.e. admin can see private statuses)
	- Improve digest email template
	– Pagination: (optional) return `total` alongside with `items` when paginating
	- The `Pleroma.FlakeId` module has been replaced with the `flake_id` library.

	### Fixed
	- Following from Osada
	- Favorites timeline doing database-intensive queries
	- Metadata rendering errors resulting in the entire page being inaccessible
	- `federation_incoming_replies_max_depth` option being ignored in certain cases
	- Mastodon API: Handling of search timeouts (`/api/v1/search` and `/api/v2/search`)
	- Mastodon API: Misskey's endless polls being unable to render
	- Mastodon API: Embedded relationships not being properly rendered in the Account entity of Status entity
	- Mastodon API: Notifications endpoint crashing if one notification failed to render
	- Mastodon API: `exclude_replies` is correctly handled again.
	- Mastodon API: Add `account_id`, `type`, `offset`, and `limit` to search API (`/api/v1/search` and `/api/v2/search`)
	- Mastodon API, streaming: Fix filtering of notifications based on blocks/mutes/thread mutes
	- Mastodon API: Fix private and direct statuses not being filtered out from the public timeline for an authenticated user (`GET /api/v1/timelines/public`)
	- Mastodon API: Ensure the `account` field is not empty when rendering Notification entities.
	- Mastodon API: Inability to get some local users by nickname in `/api/v1/accounts/:id_or_nickname`
	- Mastodon API: Blocks are now treated consistently between the Streaming API and the Timeline APIs
	- Rich Media: Parser failing when no TTL can be found by image TTL setters
	- Rich Media: The crawled URL is now spliced into the rich media data.
	- ActivityPub S2S: sharedInbox usage has been mostly aligned with the rules in the AP specification.
	- ActivityPub C2S: follower/following collection pages being inaccessible even when authentifucated if `hide_followers`/ `hide_follows` was set
	- ActivityPub: Deactivated user deletion
	- ActivityPub: Fix `/users/:nickname/inbox` crashing without an authenticated user
	- MRF: fix ability to follow a relay when AntiFollowbotPolicy was enabled
	- ActivityPub: Correct addressing of Undo.
	- ActivityPub: Correct addressing of profile update activities.
	- ActivityPub: Polls are now refreshed when necessary.
	- Report emails now include functional links to profiles of remote user accounts
	- Existing user id not being preserved on insert conflict
	- Pleroma.Upload base_url was not automatically whitelisted by MediaProxy. Now your custom CDN or file hosting will be accessed directly as expected.
	- Report email not being sent to admins when the reporter is a remote user
	- Reverse Proxy limiting `max_body_length` was incorrectly defined and only checked `Content-Length` headers which may not be sufficient in some circumstances

	### Added
	- Expiring/ephemeral activites. All activities can have expires_at value set, which controls when they should be deleted automatically.
	- Mastodon API: in post_status, the expires_in parameter lets you set the number of seconds until an activity expires. It must be at least one hour.
	- Mastodon API: all status JSON responses contain a `pleroma.expires_at` item which states when an activity will expire. The value is only shown to the user who created the activity. To everyone else it's empty.
	- Configuration: `ActivityExpiration.enabled` controls whether expired activites will get deleted at the appropriate time. Enabled by default.
	- Conversations: Add Pleroma-specific conversation endpoints and status posting extensions. Run the `bump_all_conversations` task again to create the necessary data.
	- MRF: Support for priming the mediaproxy cache (`Pleroma.Web.ActivityPub.MRF.MediaProxyWarmingPolicy`)
	- MRF: Support for excluding specific domains from Transparency.
	- MRF: Support for filtering posts based on who they mention (`Pleroma.Web.ActivityPub.MRF.MentionPolicy`)
	- Mastodon API: Support for the [`tagged` filter](https://github.com/tootsuite/mastodon/pull/9755) in [`GET /api/v1/accounts/:id/statuses`](https://docs.joinmastodon.org/api/rest/accounts/#get-api-v1-accounts-id-statuses)
	- Mastodon API, streaming: Add support for passing the token in the `Sec-WebSocket-Protocol` header
	- Mastodon API, extension: Ability to reset avatar, profile banner, and background
	- Mastodon API: Add support for `fields_attributes` API parameter (setting custom fields)
	- Mastodon API: Add support for categories for custom emojis by reusing the group feature. <https://github.com/tootsuite/mastodon/pull/11196>
	- Mastodon API: Add support for muting/unmuting notifications
	- Mastodon API: Add support for the `blocked_by` attribute in the relationship API (`GET /api/v1/accounts/relationships`). <https://github.com/tootsuite/mastodon/pull/10373>
	- Mastodon API: Add support for the `domain_blocking` attribute in the relationship API (`GET /api/v1/accounts/relationships`).
	- Mastodon API: Add `pleroma.deactivated` to the Account entity
	- Mastodon API: added `/auth/password` endpoint for password reset with rate limit.
	- Mastodon API: /api/v1/accounts/:id/statuses now supports nicknames or user id
	- Mastodon API: Improve support for the user profile custom fields
	- Mastodon API: Add support for `fields_attributes` API parameter (setting custom fields)
	- Mastodon API: Added an endpoint to get multiple statuses by IDs (`GET /api/v1/statuses/?ids[]=1&ids[]=2`)
	- Admin API: Return users' tags when querying reports
	- Admin API: Return avatar and display name when querying users
	- Admin API: Allow querying user by ID
	- Admin API: Added support for `tuples`.
	- Admin API: Added endpoints to run mix tasks pleroma.config migrate_to_db & pleroma.config migrate_from_db
	- Added synchronization of following/followers counters for external users
	- Configuration: `enabled` option for `Pleroma.Emails.Mailer`, defaulting to `false`.
	- Configuration: Pleroma.Plugs.RateLimiter `bucket_name`, `params` options.
	- Configuration: `user_bio_length` and `user_name_length` options.
	- Addressable lists
	- Twitter API: added rate limit for `/api/account/password_reset` endpoint.
	- ActivityPub: Add an internal service actor for fetching ActivityPub objects.
	- ActivityPub: Optional signing of ActivityPub object fetches.
	- Admin API: Endpoint for fetching latest user's statuses
	- Pleroma API: Add `/api/v1/pleroma/accounts/confirmation_resend?email=<email>` for resending account confirmation.
	- Pleroma API: Email change endpoint.
	- Admin API: Added moderation log
	- Web response cache (currently, enabled for ActivityPub)
	- Reverse Proxy: Do not retry failed requests to limit pressure on the peer

	### Changed
	- Configuration: Filter.AnonymizeFilename added ability to retain file extension with custom text
	- Admin API: changed json structure for saving config settings.
	- RichMedia: parsers and their order are configured in `rich_media` config.
	- RichMedia: add the rich media ttl based on image expiration time.

	## [1.0.7] - 2019-09-26
	### Fixed
	- Broken federation on Erlang 22 (previous versions of hackney http client were using an option that got deprecated)
	### Changed
	- ActivityPub: The first page in inboxes/outboxes is no longer embedded.

	## [1.0.6] - 2019-08-14
	### Fixed
	- MRF: fix use of unserializable keyword lists in describe() implementations
	- ActivityPub S2S: POST requests are now signed with `(request-target)` pseudo-header.

	## [1.0.5] - 2019-08-13
	### Fixed
	- Mastodon API: follower/following counters not being nullified, when `hide_follows`/`hide_followers` is set
	- Mastodon API: `muted` in the Status entity, using author's account to determine if the thread was muted
	- Mastodon API: return the actual profile URL in the Account entity's `url` property when appropriate
	- Templates: properly style anchor tags
	- Objects being re-embedded to activities after being updated (e.g faved/reposted). Running 'mix pleroma.database prune_objects' again is advised.
	- Not being able to access the Mastodon FE login page on private instances
	- MRF: ensure that subdomain_match calls are case-insensitive
	- Fix internal server error when using the healthcheck API.

	### Added
	- Breaking: MRF describe API, which adds support for exposing configuration information about MRF policies to NodeInfo.
	Custom modules will need to be updated by adding, at the very least, `def describe, do: {:ok, %{}}` to the MRF policy modules.
	- Relays: Added a task to list relay subscriptions.
	- MRF: Support for filtering posts based on ActivityStreams vocabulary (`Pleroma.Web.ActivityPub.MRF.VocabularyPolicy`)
	- MRF (Simple Policy): Support for wildcard domains.
	- Support for wildcard domains in user domain blocks setting.
	- Configuration: `quarantined_instances` support wildcard domains.
	- Mix Tasks: `mix pleroma.database fix_likes_collections`
	- Configuration: `federation_incoming_replies_max_depth` option

	### Removed
	- Federation: Remove `likes` from objects.
	- Breaking: ActivityPub: The `accept_blocks` configuration setting.

	## [1.0.4] - 2019-08-01
	### Fixed
	- Invalid SemVer version generation, when the current branch does not have commits ahead of tag/checked out on a tag

	## [1.0.3] - 2019-07-31
	### Security
	- OStatus: eliminate the possibility of a protocol downgrade attack.
	- OStatus: prevent following locked accounts, bypassing the approval process.
	- TwitterAPI: use CommonAPI to handle remote follows instead of OStatus.

	## [1.0.2] - 2019-07-28
	### Fixed
	- Not being able to pin unlisted posts
	- Mastodon API: represent poll IDs as strings
	- MediaProxy: fix matching filenames
	- MediaProxy: fix filename encoding
	- Migrations: fix a sporadic migration failure
	- Metadata rendering errors resulting in the entire page being inaccessible
	- Federation/MediaProxy not working with instances that have wrong certificate order
	- ActivityPub S2S: remote user deletions now work the same as local user deletions.

	### Changed
	- Configuration: OpenGraph and TwitterCard providers enabled by default
	- Configuration: Filter.AnonymizeFilename added ability to retain file extension with custom text

	## [1.0.1] - 2019-07-14
	### Security
	- OStatus: fix an object spoofing vulnerability.

	## [1.0.0] - 2019-06-29
	### Security
	- Mastodon API: Fix display names not being sanitized
	- Rich media: Do not crawl private IP ranges

	### Added
	- Digest email for inactive users
	- Add a generic settings store for frontends / clients to use.
	- Explicit addressing option for posting.
	- Optional SSH access mode. (Needs `erlang-ssh` package on some distributions).
	- [MongooseIM](https://github.com/esl/MongooseIM) http authentication support.
	- LDAP authentication
	- External OAuth provider authentication
	- Support for building a release using [`mix release`](https://hexdocs.pm/mix/master/Mix.Tasks.Release.html)
	- A [job queue](https://git.pleroma.social/pleroma/pleroma_job_queue) for federation, emails, web push, etc.
	- [Prometheus](https://prometheus.io/) metrics
	- Support for Mastodon's remote interaction
	- Mix Tasks: `mix pleroma.database bump_all_conversations`
	- Mix Tasks: `mix pleroma.database remove_embedded_objects`
	- Mix Tasks: `mix pleroma.database update_users_following_followers_counts`
	- Mix Tasks: `mix pleroma.user toggle_confirmed`
	- Mix Tasks: `mix pleroma.config migrate_to_db`
	- Mix Tasks: `mix pleroma.config migrate_from_db`
	- Federation: Support for `Question` and `Answer` objects
	- Federation: Support for reports
	- Configuration: `poll_limits` option
	- Configuration: `pack_extensions` option
	- Configuration: `safe_dm_mentions` option
	- Configuration: `link_name` option
	- Configuration: `fetch_initial_posts` option
	- Configuration: `notify_email` option
	- Configuration: Media proxy `whitelist` option
	- Configuration: `report_uri` option
	- Configuration: `email_notifications` option
	- Configuration: `limit_to_local_content` option
	- Pleroma API: User subscriptions
	- Pleroma API: Healthcheck endpoint
	- Pleroma API: `/api/v1/pleroma/mascot` per-user frontend mascot configuration endpoints
	- Admin API: Endpoints for listing/revoking invite tokens
	- Admin API: Endpoints for making users follow/unfollow each other
	- Admin API: added filters (role, tags, email, name) for users endpoint
	- Admin API: Endpoints for managing reports
	- Admin API: Endpoints for deleting and changing the scope of individual reported statuses
	- Admin API: Endpoints to view and change config settings.
	- AdminFE: initial release with basic user management accessible at /pleroma/admin/
	- Mastodon API: Add chat token to `verify_credentials` response
	- Mastodon API: Add background image setting to `update_credentials`
	- Mastodon API: [Scheduled statuses](https://docs.joinmastodon.org/api/rest/scheduled-statuses/)
	- Mastodon API: `/api/v1/notifications/destroy_multiple` (glitch-soc extension)
	- Mastodon API: `/api/v1/pleroma/accounts/:id/favourites` (API extension)
	- Mastodon API: [Reports](https://docs.joinmastodon.org/api/rest/reports/)
	- Mastodon API: `POST /api/v1/accounts` (account creation API)
	- Mastodon API: [Polls](https://docs.joinmastodon.org/api/rest/polls/)
	- ActivityPub C2S: OAuth endpoints
	- Metadata: RelMe provider
	- OAuth: added support for refresh tokens
	- Emoji packs and emoji pack manager
	- Object pruning (`mix pleroma.database prune_objects`)
	- OAuth: added job to clean expired access tokens
	- MRF: Support for rejecting reports from specific instances (`mrf_simple`)
	- MRF: Support for stripping avatars and banner images from specific instances (`mrf_simple`)
	- MRF: Support for running subchains.
	- Configuration: `skip_thread_containment` option
	- Configuration: `rate_limit` option. See `Pleroma.Plugs.RateLimiter` documentation for details.
	- MRF: Support for filtering out likely spam messages by rejecting posts from new users that contain links.
	- Configuration: `ignore_hosts` option
	- Configuration: `ignore_tld` option
	- Configuration: default syslog tag "Pleroma" is now lowercased to "pleroma"

	### Changed
	- Breaking: bind to 127.0.0.1 instead of 0.0.0.0 by default
	- Breaking: Configuration: move from Pleroma.Mailer to Pleroma.Emails.Mailer
	- Thread containment / test for complete visibility will be skipped by default.
	- Enforcement of OAuth scopes
	- Add multiple use/time expiring invite token
	- Restyled OAuth pages to fit with Pleroma's default theme
	- Link/mention/hashtag detection is now handled by [auto_linker](https://git.pleroma.social/pleroma/auto_linker)
	- NodeInfo: Return `safe_dm_mentions` feature flag
	- Federation: Expand the audience of delete activities to all recipients of the deleted object
	- Federation: Removed `inReplyToStatusId` from objects
	- Configuration: Dedupe enabled by default
	- Configuration: Default log level in `prod` environment is now set to `warn`
	- Configuration: Added `extra_cookie_attrs` for setting non-standard cookie attributes. Defaults to ["SameSite=Lax"] so that remote follows work.
	- Timelines: Messages involving people you have blocked will be excluded from the timeline in all cases instead of just repeats.
	- Admin API: Move the user related API to `api/pleroma/admin/users`
	- Admin API: `POST /api/pleroma/admin/users` will take list of users
	- Pleroma API: Support for emoji tags in `/api/pleroma/emoji` resulting in a breaking API change
	- Mastodon API: Support for `exclude_types`, `limit` and `min_id` in `/api/v1/notifications`
	- Mastodon API: Add `languages` and `registrations` to `/api/v1/instance`
	- Mastodon API: Provide plaintext versions of cw/content in the Status entity
	- Mastodon API: Add `pleroma.conversation_id`, `pleroma.in_reply_to_account_acct` fields to the Status entity
	- Mastodon API: Add `pleroma.tags`, `pleroma.relationship{}`, `pleroma.is_moderator`, `pleroma.is_admin`, `pleroma.confirmation_pending`, `pleroma.hide_followers`, `pleroma.hide_follows`, `pleroma.hide_favorites` fields to the User entity
	- Mastodon API: Add `pleroma.show_role`, `pleroma.no_rich_text` fields to the Source subentity
	- Mastodon API: Add support for updating `no_rich_text`, `hide_followers`, `hide_follows`, `hide_favorites`, `show_role` in `PATCH /api/v1/update_credentials`
	- Mastodon API: Add `pleroma.is_seen` to the Notification entity
	- Mastodon API: Add `pleroma.local` to the Status entity
	- Mastodon API: Add `preview` parameter to `POST /api/v1/statuses`
	- Mastodon API: Add `with_muted` parameter to timeline endpoints
	- Mastodon API: Actual reblog hiding instead of a dummy
	- Mastodon API: Remove attachment limit in the Status entity
	- Mastodon API: Added support max_id & since_id for bookmark timeline endpoints.
	- Deps: Updated Cowboy to 2.6
	- Deps: Updated Ecto to 3.0.7
	- Don't ship finmoji by default, they can be installed as an emoji pack
	- Hide deactivated users and their statuses
	- Posts which are marked sensitive or tagged nsfw no longer have link previews.
	- HTTP connection timeout is now set to 10 seconds.
	- Respond with a 404 Not implemented JSON error message when requested API is not implemented
	- Rich Media: crawl only https URLs.

	### Fixed
	- Follow requests don't get 'stuck' anymore.
	- Added an FTS index on objects. Running `vacuum analyze` and setting a larger `work_mem` is recommended.
	- Followers counter not being updated when a follower is blocked
	- Deactivated users being able to request an access token
	- Limit on request body in rich media/relme parsers being ignored resulting in a possible memory leak
	- Proper Twitter Card generation instead of a dummy
	- Deletions failing for users with a large number of posts
	- NodeInfo: Include admins in `staffAccounts`
	- ActivityPub: Crashing when requesting empty local user's outbox
	- Federation: Handling of objects without `summary` property
	- Federation: Add a language tag to activities as required by ActivityStreams 2.0
	- Federation: Do not federate avatar/banner if set to default allowing other servers/clients to use their defaults
	- Federation: Cope with missing or explicitly nulled address lists
	- Federation: Explicitly ensure activities addressed to `as:Public` become addressed to the followers collection
	- Federation: Better cope with actors which do not declare a followers collection and use `as:Public` with these semantics
	- Federation: Follow requests from remote users who have been blocked will be automatically rejected if appropriate
	- MediaProxy: Parse name from content disposition headers even for non-whitelisted types
	- MediaProxy: S3 link encoding
	- Rich Media: Reject any data which cannot be explicitly encoded into JSON
	- Pleroma API: Importing follows from Mastodon 2.8+
	- Twitter API: Exposing default scope, `no_rich_text` of the user to anyone
	- Twitter API: Returning the `role` object in user entity despite `show_role = false`
	- Mastodon API: `/api/v1/favourites` serving only public activities
	- Mastodon API: Reblogs having `in_reply_to_id` - `null` even when they are replies
	- Mastodon API: Streaming API broadcasting wrong activity id
	- Mastodon API: 500 errors when requesting a card for a private conversation
	- Mastodon API: Handling of `reblogs` in `/api/v1/accounts/:id/follow`
	- Mastodon API: Correct `reblogged`, `favourited`, and `bookmarked` values in the reblog status JSON
	- Mastodon API: Exposing default scope of the user to anyone
	- Mastodon API: Make `irreversible` field default to `false` [`POST /api/v1/filters`]
	- Mastodon API: Replace missing non-nullable Card attributes with empty strings
	- User-Agent is now sent correctly for all HTTP requests.
	- MRF: Simple policy now properly delists imported or relayed statuses

	## Removed
	- Configuration: `config :pleroma, :fe` in favor of the more flexible `config :pleroma, :frontend_configurations`

	## [0.9.99999] - 2019-05-31
	### Security
	- Mastodon API: Fix lists leaking private posts

	## [0.9.9999] - 2019-04-05
	### Security
	- Mastodon API: Fix content warnings skipping HTML sanitization

	## [0.9.999] - 2019-03-13
	Frontend changes only.
	### Added
	- Added floating action button for posting status on mobile
	### Changed
	- Changed user-settings icon to a pencil
	### Fixed
	- Keyboard shortcuts activating when typing a message
	- Gaps when scrolling down on a timeline after showing new

	## [0.9.99] - 2019-03-08
	### Changed
	- Update the frontend to the 0.9.99 tag
	### Fixed
	- Sign the date header in federation to fix Mastodon federation.

	## [0.9.9] - 2019-02-22
	This is our first stable release.
	diff --git a/docs/docs/administration/CLI_tasks/instance.md b/docs/docs/administration/CLI_tasks/instance.md
	index 5c93cdb30..1a3f8153e 100644
	--- a/docs/docs/administration/CLI_tasks/instance.md
	+++ b/docs/docs/administration/CLI_tasks/instance.md
	@@ -1,44 +1,45 @@
	# Managing instance configuration

	{! administration/CLI_tasks/general_cli_task_info.include !}

	## Generate a new configuration file
	=== "OTP"

	```sh
	./bin/pleroma_ctl instance gen [option ...]
	```

	=== "From Source"

	```sh
	mix pleroma.instance gen [option ...]
	```


	If any of the options are left unspecified, you will be prompted interactively.

	### Options
	- `-f`, `--force` - overwrite any output files
	- `-o <path>`, `--output <path>` - the output file for the generated configuration
	- `--output-psql <path>` - the output file for the generated PostgreSQL setup
	- `--domain <domain>` - the domain of your instance
	- `--instance-name <instance_name>` - the name of your instance
	- `--admin-email <email>` - the email address of the instance admin
	- `--notify-email <email>` - email address for notifications
	- `--dbhost <hostname>` - the hostname of the PostgreSQL database to use
	- `--dbname <database_name>` - the name of the database to use
	- `--dbuser <username>` - the user (aka role) to use for the database connection
	- `--dbpass <password>` - the password to use for the database connection
	- `--rum <Y\|N>` - Whether to enable RUM indexes
	- `--indexable <Y\|N>` - Allow/disallow indexing site by search engines
	- `--db-configurable <Y\|N>` - Allow/disallow configuring instance from admin part
	- `--uploads-dir <path>` - the directory uploads go in when using a local uploader
	- `--static-dir <path>` - the directory custom public files should be read from (custom emojis, frontend bundle overrides, robots.txt, etc.)
	- `--listen-ip <ip>` - the ip the app should listen to, defaults to 127.0.0.1
	- `--listen-port <port>` - the port the app should listen to, defaults to 4000
	-- `--strip-uploads <Y\|N>` - use ExifTool to strip uploads of sensitive location data
	+- `--strip-uploads-metadata <Y\|N>` - use ExifTool to strip uploads of sensitive metadata
	+- `--read-uploads-description <Y\|N>` - use ExifTool to read image descriptions from uploads
	- `--anonymize-uploads <Y\|N>` - randomize uploaded filenames
	- `--dedupe-uploads <Y\|N>` - store files based on their hash to reduce data storage requirements if duplicates are uploaded with different filenames
	- `--skip-release-env` - skip generation the release environment file
	- `--release-env-file` - release environment file path
	diff --git a/docs/docs/configuration/cheatsheet.md b/docs/docs/configuration/cheatsheet.md
	index d238d73aa..d2b699a51 100644
	--- a/docs/docs/configuration/cheatsheet.md
	+++ b/docs/docs/configuration/cheatsheet.md
	@@ -1,1207 +1,1214 @@
	# Configuration Cheat Sheet

	This is a cheat sheet for Akkoma configuration file, any setting possible to configure should be listed here.

	For OTP installations the configuration is typically stored in `/etc/akkoma/config.exs`.

	For from source installations Akkoma configuration works by first importing the base config `config/config.exs`, then overriding it by the environment config `config/$MIX_ENV.exs` and then overriding it by user config `config/$MIX_ENV.secret.exs`. In from source installations you should always make the changes to the user config and NEVER to the base config to avoid breakages and merge conflicts. So for production you change/add configuration to `config/prod.secret.exs`.

	To add configuration to your config file, you can copy it from the base config. The latest version of it can be viewed [here](https://akkoma.dev/AkkomaGang/akkoma/src/branch/develop/config/config.exs). You can also use this file if you don't know how an option is supposed to be formatted.

	## :instance
	* `name`: The instance’s name.
	* `email`: Email used to reach an Administrator/Moderator of the instance.
	* `notify_email`: Email used for notifications.
	* `description`: The instance’s description, can be seen in nodeinfo and ``/api/v1/instance``.
	* `limit`: Posts character limit (CW/Subject included in the counter).
	* `description_limit`: The character limit for image descriptions.
	* `remote_limit`: Hard character limit beyond which remote posts will be dropped.
	* `upload_limit`: File size limit of uploads (except for avatar, background, banner).
	* `avatar_upload_limit`: File size limit of user’s profile avatars.
	* `background_upload_limit`: File size limit of user’s profile backgrounds.
	* `banner_upload_limit`: File size limit of user’s profile banners.
	* `poll_limits`: A map with poll limits for local polls.
	* `max_options`: Maximum number of options.
	* `max_option_chars`: Maximum number of characters per option.
	* `min_expiration`: Minimum expiration time (in seconds).
	* `max_expiration`: Maximum expiration time (in seconds).
	* `registrations_open`: Enable registrations for anyone, invitations can be enabled when false.
	* `invites_enabled`: Enable user invitations for admins (depends on `registrations_open: false`).
	* `account_activation_required`: Require users to confirm their emails before signing in.
	* `account_approval_required`: Require users to be manually approved by an admin before signing in.
	* `federating`: Enable federation with other instances.
	* `federation_incoming_replies_max_depth`: Max. depth of reply-to activities fetching on incoming federation, to prevent out-of-memory situations while fetching very long threads. If set to `nil`, threads of any depth will be fetched. Lower this value if you experience out-of-memory crashes.
	* `federation_reachability_timeout_days`: Timeout (in days) of each external federation target being unreachable prior to pausing federating to it.
	* `allow_relay`: Permits remote instances to subscribe to all public posts of your instance. This may increase the visibility of your instance.
	* `public`: Allows unauthenticated access to public resources on your instance. This is essentially used as the default value for `:restrict_unauthenticated`.
	See `restrict_unauthenticated` for more details.
	* `quarantined_instances`: DEPRECATED ActivityPub instances where activities will not be sent. They can still reach there via other means, we just won't send them.
	* `allowed_post_formats`: MIME-type list of formats allowed to be posted (transformed into HTML).
	* `extended_nickname_format`: Set to `true` to use extended local nicknames format (allows underscores/dashes). This will break federation with
	older software for theses nicknames.
	* `max_pinned_statuses`: The maximum number of pinned statuses. `0` will disable the feature.
	* `autofollowed_nicknames`: Set to nicknames of (local) users that every new user should automatically follow.
	* `autofollowing_nicknames`: Set to nicknames of (local) users that automatically follows every newly registered user.
	* `attachment_links`: Set to true to enable automatically adding attachment link text to statuses.
	* `max_report_comment_size`: The maximum size of the report comment (Default: `1000`).
	* `safe_dm_mentions`: If set to true, only mentions at the beginning of a post will be used to address people in direct messages. This is to prevent accidental mentioning of people when talking about them (e.g. "@friend hey i really don't like @enemy"). Default: `false`.
	* `healthcheck`: If set to true, system data will be shown on ``/api/v1/pleroma/healthcheck``.
	* `remote_post_retention_days`: The default amount of days to retain remote posts when pruning the database.
	* `user_bio_length`: A user bio maximum length (default: `5000`).
	* `user_name_length`: A user name maximum length (default: `100`).
	* `skip_thread_containment`: Skip filter out broken threads. The default is `false`.
	* `limit_to_local_content`: Limit unauthenticated users to search for local statutes and users only. Possible values: `:unauthenticated`, `:all` and `false`. The default is `:unauthenticated`.
	* `max_account_fields`: The maximum number of custom fields in the user profile (default: `10`).
	* `max_remote_account_fields`: The maximum number of custom fields in the remote user profile (default: `20`).
	* `account_field_name_length`: An account field name maximum length (default: `512`).
	* `account_field_value_length`: An account field value maximum length (default: `2048`).
	* `registration_reason_length`: Maximum registration reason length (default: `500`).
	* `external_user_synchronization`: Enabling following/followers counters synchronization for external users.
	* `cleanup_attachments`: Remove attachments along with statuses. Does not affect duplicate files and attachments without status. Enabling this will increase load to database when deleting statuses on larger instances.
	* `show_reactions`: Let favourites and emoji reactions be viewed through the API (default: `true`).
	* `password_reset_token_validity`: The time after which reset tokens aren't accepted anymore, in seconds (default: one day).
	* `local_bubble`: Array of domains representing instances closely related to yours. Used to populate the `bubble` timeline. e.g `["example.com"]`, (default: `[]`)
	* `languages`: List of Language Codes used by the instance. This is used to try and set a default language from the frontend. It will try and find the first match between the languages set here and the user's browser languages. It will default to the first language in this setting if there is no match.. (default `["en"]`)
	* `export_prometheus_metrics`: Enable prometheus metrics, served at `/api/v1/akkoma/metrics`, requiring the `admin:metrics` oauth scope.

	## :database
	* `improved_hashtag_timeline`: Setting to force toggle / force disable improved hashtags timeline. `:enabled` forces hashtags to be fetched from `hashtags` table for hashtags timeline. `:disabled` forces object-embedded hashtags to be used (slower). Keep it `:auto` for automatic behaviour (it is auto-set to `:enabled` [unless overridden] when HashtagsTableMigrator completes).

	## Background migrations
	* `populate_hashtags_table/sleep_interval_ms`: Sleep interval between each chunk of processed records in order to decrease the load on the system (defaults to 0 and should be keep default on most instances).
	* `populate_hashtags_table/fault_rate_allowance`: Max rate of failed objects to actually processed objects in order to enable the feature (any value from 0.0 which tolerates no errors to 1.0 which will enable the feature even if hashtags transfer failed for all records).

	## Welcome
	* `direct_message`: - welcome message sent as a direct message.
	* `enabled`: Enables the send a direct message to a newly registered user. Defaults to `false`.
	* `sender_nickname`: The nickname of the local user that sends the welcome message.
	* `message`: A message that will be send to a newly registered users as a direct message.
	* `email`: - welcome message sent as a email.
	* `enabled`: Enables the send a welcome email to a newly registered user. Defaults to `false`.
	* `sender`: The email address or tuple with `{nickname, email}` that will use as sender to the welcome email.
	* `subject`: A subject of welcome email.
	* `html`: A html that will be send to a newly registered users as a email.
	* `text`: A text that will be send to a newly registered users as a email.

	Example:

	```elixir
	config :pleroma, :welcome,
	direct_message: [
	enabled: true,
	sender_nickname: "lain",
	message: "Hi! Welcome on board!"
	],
	email: [
	enabled: true,
	sender: {"Akkoma App", "welcome@akkoma.app"},
	subject: "Welcome to <%= instance_name %>",
	html: "Welcome to <%= instance_name %>",
	text: "Welcome to <%= instance_name %>"
	]
	```

	## Message rewrite facility

	### :mrf
	* `transparency`: Make the content of your Message Rewrite Facility settings public (via nodeinfo).
	* `transparency_exclusions`: Exclude specific instance names from MRF transparency. The use of the exclusions feature will be disclosed in nodeinfo as a boolean value.
	* `transparency_obfuscate_domains`: Show domains with `` in the middle, to censor them if needed. For example, `ridingho.me` will show as `rid****.me`
	* `policies`: Message Rewrite Policy, either one or a list. Here are the ones available by default:
	* `Pleroma.Web.ActivityPub.MRF.NoOpPolicy`: Doesn’t modify activities (default).
	* `Pleroma.Web.ActivityPub.MRF.DropPolicy`: Drops all activities. It generally doesn’t makes sense to use in production.
	* `Pleroma.Web.ActivityPub.MRF.ActivityExpirationPolicy`: Sets a default expiration on all posts made by users of the local instance. Requires `Pleroma.Workers.PurgeExpiredActivity` to be enabled for processing the scheduled delections.
	(See [`:mrf_activity_expiration`](#mrf_activity_expiration))
	* `Pleroma.Web.ActivityPub.MRF.AntiFollowbotPolicy`: Drops follow requests from followbots. Users can still allow bots to follow them by first following the bot.
	* `Pleroma.Web.ActivityPub.MRF.AntiLinkSpamPolicy`: Rejects posts from likely spambots by rejecting posts from new users that contain links.
	* `Pleroma.Web.ActivityPub.MRF.EnsureRePrepended`: Rewrites posts to ensure that replies to posts with subjects do not have an identical subject and instead begin with re:.
	* `Pleroma.Web.ActivityPub.MRF.ForceBotUnlistedPolicy`: Makes all bot posts to disappear from public timelines.
	* `Pleroma.Web.ActivityPub.MRF.HellthreadPolicy`: Blocks messages with too many mentions.
	(See [`mrf_hellthread`](#mrf_hellthread))
	* `Pleroma.Web.ActivityPub.MRF.KeywordPolicy`: Rejects or removes from the federated timeline or replaces keywords. (See [`:mrf_keyword`](#mrf_keyword)).
	* `Pleroma.Web.ActivityPub.MRF.MediaProxyWarmingPolicy`: Crawls attachments using their MediaProxy URLs so that the MediaProxy cache is primed.
	* `Pleroma.Web.ActivityPub.MRF.MentionPolicy`: Drops posts mentioning configurable users. (See [`:mrf_mention`](#mrf_mention)).
	* `Pleroma.Web.ActivityPub.MRF.NoEmptyPolicy`: Drops local activities which have no actual content.
	(e.g. no attachments and only consists of mentions)
	* `Pleroma.Web.ActivityPub.MRF.NoPlaceholderTextPolicy`: Strips content placeholders from posts
	(such as the dot from mastodon)
	* `Pleroma.Web.ActivityPub.MRF.ObjectAgePolicy`: Rejects or delists posts based on their age when received. (See [`:mrf_object_age`](#mrf_object_age)).
	* `Pleroma.Web.ActivityPub.MRF.RejectNewlyCreatedAccountNotesPolicy`: Rejects posts of users the server only recently learned about for a while. Great to block spam accounts. (See [`:mrf_reject_newly_created_account_notes`](#mrf_reject_newly_created_account_notes))
	* `Pleroma.Web.ActivityPub.MRF.RejectNonPublic`: Drops posts with non-public visibility settings (See [`:mrf_rejectnonpublic`](#mrf_rejectnonpublic)).
	* `Pleroma.Web.ActivityPub.MRF.SimplePolicy`: Restrict the visibility of activities from certains instances (See [`:mrf_simple`](#mrf_simple)).
	* `Pleroma.Web.ActivityPub.MRF.StealEmojiPolicy`: Steals all eligible emoji encountered in posts from remote instances
	(See [`:mrf_steal_emoji`](#mrf_steal_emoji))
	* `Pleroma.Web.ActivityPub.MRF.SubchainPolicy`: Selectively runs other MRF policies when messages match (See [`:mrf_subchain`](#mrf_subchain)).
	* `Pleroma.Web.ActivityPub.MRF.TagPolicy`: Applies policies to individual users based on tags, which can be set using pleroma-fe/admin-fe/any other app that supports Pleroma Admin API. For example it allows marking posts from individual users nsfw (sensitive).
	* `Pleroma.Web.ActivityPub.MRF.UserAllowListPolicy`: Drops all posts except from users specified in a list.
	(See [`:mrf_user_allowlist`](#mrf_user_allowlist))
	* `Pleroma.Web.ActivityPub.MRF.VocabularyPolicy`: Restricts activities to a configured set of vocabulary. (See [`:mrf_vocabulary`](#mrf_vocabulary)).

	Additionally the following MRFs will always be aplied and cannot be disabled:

	* `Pleroma.Web.ActivityPub.MRF.DirectMessageDisabledPolicy`: Strips users limiting who can send them DMs from the recipients of non-eligible DMs
	* `Pleroma.Web.ActivityPub.MRF.HashtagPolicy`: Depending on a post’s hashtags it can be rejected, get its sensitive flags force-enabled or removed from the global timeline
	(See [`:mrf_hashtag`](#mrf_hashtag))
	* `Pleroma.Web.ActivityPub.MRF.InlineQuotePolicy`: Append a link to a post that quotes another post with the link to the quoted post, to ensure that software that does not understand quotes can have full context.
	(See [`:mrf_inline_quote`](#mrf_inline_quote))
	* `Pleroma.Web.ActivityPub.MRF.NormalizeMarkup`: Pass inbound HTML through a scrubber to make sure it doesn't have anything unusual in it.
	(See [`:mrf_normalize_markup`](#mrf_normalize_markup))


	## Federation
	### :activitypub
	* `unfollow_blocked`: Whether blocks result in people getting unfollowed
	* `outgoing_blocks`: Whether to federate blocks to other instances
	* `blockers_visible`: Whether a user can see the posts of users who blocked them
	* `deny_follow_blocked`: Whether to disallow following an account that has blocked the user in question
	* `sign_object_fetches`: Sign object fetches with HTTP signatures
	* `authorized_fetch_mode`: Require HTTP signatures for AP fetches
	* `max_collection_objects`: The maximum number of objects to fetch from a remote AP collection.

	### MRF policies

	!!! note
	Configuring MRF policies is not enough for them to take effect. You have to enable them by specifying their module in `policies` under [:mrf](#mrf) section.

	#### :mrf_simple
	* `media_removal`: List of instances to strip media attachments from and the reason for doing so.
	* `media_nsfw`: List of instances to tag all media as NSFW (sensitive) from and the reason for doing so.
	* `federated_timeline_removal`: List of instances to remove from the Federated Timeline (aka The Whole Known Network) and the reason for doing so.
	* `reject`: List of instances to reject activities (except deletes) from and the reason for doing so. Additionally prevents activities from being sent to that instance.
	* `accept`: List of instances to only accept activities (except deletes) from and the reason for doing so.
	* `followers_only`: Force posts from the given instances to be visible by followers only and the reason for doing so.
	* `report_removal`: List of instances to reject reports from and the reason for doing so.
	* `avatar_removal`: List of instances to strip avatars from and the reason for doing so.
	* `banner_removal`: List of instances to strip banners from and the reason for doing so.
	* `background_removal`: List of instances to strip user backgrounds from and the reason for doing so.
	* `reject_deletes`: List of instances to reject deletions from and the reason for doing so.

	#### :mrf_subchain
	This policy processes messages through an alternate pipeline when a given message matches certain criteria.
	All criteria are configured as a map of regular expressions to lists of policy modules.

	* `match_actor`: Matches a series of regular expressions against the actor field.

	Example:

	```elixir
	config :pleroma, :mrf_subchain,
	match_actor: %{
	~r/https:\/\/example.com/s => [Pleroma.Web.ActivityPub.MRF.DropPolicy]
	}
	```

	#### :mrf_rejectnonpublic
	* `allow_followersonly`: whether to allow followers-only posts.
	* `allow_direct`: whether to allow direct messages.

	#### :mrf_hellthread
	* `delist_threshold`: Number of mentioned users after which the message gets delisted (the message can still be seen, but it will not show up in public timelines and mentioned users won't get notifications about it). Set to 0 to disable.
	* `reject_threshold`: Number of mentioned users after which the messaged gets rejected. Set to 0 to disable.

	#### :mrf_keyword
	* `reject`: A list of patterns which result in message being rejected, each pattern can be a string or a [regular expression](https://hexdocs.pm/elixir/Regex.html).
	* `federated_timeline_removal`: A list of patterns which result in message being removed from federated timelines (a.k.a unlisted), each pattern can be a string or a [regular expression](https://hexdocs.pm/elixir/Regex.html).
	* `replace`: A list of tuples containing `{pattern, replacement}`, `pattern` can be a string or a [regular expression](https://hexdocs.pm/elixir/Regex.html).

	#### :mrf_mention
	* `actors`: A list of actors, for which to drop any posts mentioning.

	#### :mrf_vocabulary
	* `accept`: A list of ActivityStreams terms to accept. If empty, all supported messages are accepted.
	* `reject`: A list of ActivityStreams terms to reject. If empty, no messages are rejected.

	#### :mrf_user_allowlist

	The keys in this section are the domain names that the policy should apply to.
	Each key should be assigned a list of users that should be allowed through by
	their ActivityPub ID.

	An example:

	```elixir
	config :pleroma, :mrf_user_allowlist, %{
	"example.org" => ["https://example.org/users/admin"]
	}
	```

	#### :mrf_object_age
	* `threshold`: Required time offset (in seconds) compared to your server clock of an incoming post before actions are taken.
	e.g., A value of 900 results in any post with a timestamp older than 15 minutes will be acted upon.
	* `actions`: A list of actions to apply to the post:
	* `:delist` removes the post from public timelines
	* `:strip_followers` removes followers from the ActivityPub recipient list, ensuring they won't be delivered to home timelines
	* `:reject` rejects the message entirely

	#### :mrf_steal_emoji
	* `hosts`: List of hosts to steal emojis from
	* `rejected_shortcodes`: Regex-list of shortcodes to reject
	* `size_limit`: File size limit (in bytes), checked before download if possible (and remote server honest),
	otherwise or again checked before saving emoji to the disk
	* `download_unknown_size`: whether to download an emoji when the remote server doesn’t report its size in advance

	#### :mrf_activity_expiration

	* `days`: Default global expiration time for all local Create activities (in days)

	#### :mrf_hashtag

	* `sensitive`: List of hashtags to mark activities as sensitive (default: `nsfw`)
	* `federated_timeline_removal`: List of hashtags to remove activities from the federated timeline (aka TWNK)
	* `reject`: List of hashtags to reject activities from

	Notes:
	- The hashtags in the configuration do not have a leading `#`.
	- This MRF Policy is always enabled, if you want to disable it you have to set empty lists

	#### :mrf_reject_newly_created_account_notes
	After initially encountering an user, all their posts
	will be rejected for the configured time (in seconds).
	Only drops posts. Follows, reposts, etc. are not affected.

	* `age`: Time below which to reject (in seconds)

	An example: (86400 seconds = 24 hours)

	```elixir
	config :pleroma, :mrf_reject_newly_created_account_notes, age: 86400
	```

	#### :mrf_inline_quote
	* `prefix`: what prefix to prepend to quoted URLs

	#### :mrf_normalize_markup
	* `scrub_policy`: the scrubbing module to use (by default a built-in HTML sanitiser)

	## Pleroma.User

	* `restricted_nicknames`: List of nicknames users may not register with.
	* `email_blacklist`: List of email domains users may not register with.

	## Pleroma.ScheduledActivity

	* `daily_user_limit`: the number of scheduled activities a user is allowed to create in a single day (Default: `25`)
	* `total_user_limit`: the number of scheduled activities a user is allowed to create in total (Default: `300`)
	* `enabled`: whether scheduled activities are sent to the job queue to be executed

	## Frontend Management

	### :frontend_configurations

	This can be used to configure a keyword list that keeps the configuration data for any kind of frontend. By default, settings for `pleroma_fe` and `masto_fe` are configured. You can find the documentation for `pleroma_fe` configuration into [Akkoma-FE configuration and customization for instance administrators](https://docs-fe.akkoma.dev/stable/CONFIGURATION/#options).

	Frontends can access these settings at `/api/v1/pleroma/frontend_configurations`

	To add your own configuration for Akkoma-FE, use it like this:

	```elixir
	config :pleroma, :frontend_configurations,
	pleroma_fe: %{
	theme: "pleroma-dark",
	# ... see /priv/static/static/config.json for the available keys.
	},
	masto_fe: %{
	showInstanceSpecificPanel: true
	}
	```

	These settings need to be complete, they will override the defaults.

	### :frontends

	These settings tell akkoma which frontend files to serve the user.

	See: [Frontend Management](../frontend_management)

	```elixir
	config :pleroma, :frontends,
	primary: %{
	"name" => "pleroma-fe",
	"ref" => "develop"
	},
	admin: %{
	"name" => "admin-fe",
	"ref" => "develop"
	},
	swagger: %{
	"name" => "swagger-ui",
	"ref" => "stable",
	"enabled" => true
	},
	mastodon: %{
	"name" => "mastodon-fe",
	"ref" => "akkoma"
	}
	```

	* `:primary` - The frontend that will be served at `/`
	* `:admin` - The frontend that will be served at `/pleroma/admin`
	* `:swagger` - Config for developers to act as an API reference to be served at `/akkoma/swaggerui/` (trailing slash _needed_). Disabled by default.
	* `:mastodon` - The mastodon-fe configuration. This shouldn't need to be changed. This is served at `/web` when installed.

	### :static\_fe

	Render profiles and posts using server-generated HTML that is viewable without using JavaScript.

	Available options:

	* `enabled` - Enables the rendering of static HTML. Defaults to `false`.

	### :assets

	This section configures assets to be used with various frontends. Currently the only option
	relates to mascots on the mastodon frontend

	* `mascots`: KeywordList of mascots, each element __MUST__ contain both a `url` and a
	`mime_type` key.
	* `default_mascot`: An element from `mascots` - This will be used as the default mascot
	on MastoFE (default: `:pleroma_fox_tan`).

	### :manifest

	This section describe PWA manifest instance-specific values. Currently this option relate only for MastoFE.

	* `icons`: Describe the icons of the app, this a list of maps describing icons in the same way as the
	[spec](https://www.w3.org/TR/appmanifest/#imageresource-and-its-members) describes it.

	Example:

	```elixir
	config :pleroma, :manifest,
	icons: [
	%{
	src: "/static/logo.png"
	},
	%{
	src: "/static/icon.png",
	type: "image/png"
	},
	%{
	src: "/static/icon.ico",
	sizes: "72x72 96x96 128x128 256x256"
	}
	]
	```

	* `theme_color`: Describe the theme color of the app. (Example: `"#282c37"`, `"rebeccapurple"`).
	* `background_color`: Describe the background color of the app. (Example: `"#191b22"`, `"aliceblue"`).

	## :emoji

	* `shortcode_globs`: Location of custom emoji files. `` can be used as a wildcard. Example `["/emoji/custom//.png"]`
	* `pack_extensions`: A list of file extensions for emojis, when no emoji.txt for a pack is present. Example `[".png", ".gif"]`
	* `groups`: Emojis are ordered in groups (tags). This is an array of key-value pairs where the key is the groupname and the value the location or array of locations. `` can be used as a wildcard. Example `[Custom: ["/emoji/.png", "/emoji/custom/*.png"]]`
	* `default_manifest`: Location of the JSON-manifest. This manifest contains information about the emoji-packs you can download. Currently only one manifest can be added (no arrays).
	* `shared_pack_cache_seconds_per_file`: When an emoji pack is shared, the archive is created and cached in
	memory for this amount of seconds multiplied by the number of files.

	## :media_proxy

	* `enabled`: Enables proxying of remote media to the instance’s proxy
	* `base_url`: The base URL to access a user-uploaded file.
	Using a (sub)domain distinct from the instance endpoint is strongly recommended.
	* `proxy_opts`: All options defined in `Pleroma.ReverseProxy` documentation, defaults to `[max_body_length: (25*1_048_576)]`.
	* `whitelist`: List of hosts with scheme to bypass the mediaproxy (e.g. `https://example.com`)
	* `invalidation`: options for remove media from cache after delete object:
	* `enabled`: Enables purge cache
	* `provider`: Which one of the [purge cache strategy](#purge-cache-strategy) to use.

	## :media_preview_proxy

	* `enabled`: Enables proxying of remote media preview to the instance’s proxy. Requires enabled media proxy (`media_proxy/enabled`).
	* `thumbnail_max_width`: Max width of preview thumbnail for images (video preview always has original dimensions).
	* `thumbnail_max_height`: Max height of preview thumbnail for images (video preview always has original dimensions).
	* `image_quality`: Quality of the output. Ranges from 0 (min quality) to 100 (max quality).
	* `min_content_length`: Min content length to perform preview, in bytes. If greater than 0, media smaller in size will be served as is, without thumbnailing.

	### Purge cache strategy

	#### Pleroma.Web.MediaProxy.Invalidation.Script

	This strategy allow perform external shell script to purge cache.
	Urls of attachments are passed to the script as arguments.

	* `script_path`: Path to the external script.
	* `url_format`: Set to `:htcacheclean` if using Apache's htcacheclean utility.

	Example:

	```elixir
	config :pleroma, Pleroma.Web.MediaProxy.Invalidation.Script,
	script_path: "./installation/nginx-cache-purge.example"
	```

	#### Pleroma.Web.MediaProxy.Invalidation.Http

	This strategy allow perform custom http request to purge cache.

	* `method`: http method. default is `purge`
	* `headers`: http headers.
	* `options`: request options.

	Example:
	```elixir
	config :pleroma, Pleroma.Web.MediaProxy.Invalidation.Http,
	method: :purge,
	headers: [],
	options: []
	```

	## Link previews

	### Pleroma.Web.Metadata (provider)
	* `providers`: a list of metadata providers to enable. Providers available:
	* `Pleroma.Web.Metadata.Providers.OpenGraph`
	* `Pleroma.Web.Metadata.Providers.TwitterCard`
	* `unfurl_nsfw`: If set to `true` nsfw attachments will be shown in previews.

	### :rich_media (consumer)
	* `enabled`: if enabled the instance will parse metadata from attached links to generate link previews.
	* `ignore_hosts`: list of hosts which will be ignored by the metadata parser. For example `["accounts.google.com", "xss.website"]`, defaults to `[]`.
	* `ignore_tld`: list TLDs (top-level domains) which will ignore for parse metadata. default is ["local", "localdomain", "lan"].
	* `parsers`: list of Rich Media parsers.
	* `failure_backoff`: Amount of milliseconds after request failure, during which the request will not be retried.

	## HTTP server

	### Pleroma.Web.Endpoint

	!!! note
	`Phoenix` endpoint configuration, all configuration options can be viewed [here](https://hexdocs.pm/phoenix/Phoenix.Endpoint.html#module-dynamic-configuration), only common options are listed here.

	* `http` - a list containing http protocol configuration, all configuration options can be viewed [here](https://hexdocs.pm/plug_cowboy/Plug.Cowboy.html#module-options), only common options are listed here. For deployment using docker, you need to set this to `[ip: {0,0,0,0}, port: 4000]` to make akkoma accessible from other containers (such as your nginx server).
	- `ip` - a tuple consisting of 4 integers
	- `port`
	* `url` - a list containing the configuration for generating urls, accepts
	- `host` - the host without the scheme and a post (e.g `example.com`, not `https://example.com:2020`)
	- `scheme` - e.g `http`, `https`
	- `port`
	- `path`
	* `extra_cookie_attrs` - a list of `Key=Value` strings to be added as non-standard cookie attributes. Defaults to `["SameSite=Lax"]`. See the [SameSite article](https://www.owasp.org/index.php/SameSite) on OWASP for more info.

	Example:
	```elixir
	config :pleroma, Pleroma.Web.Endpoint,
	url: [host: "example.com", port: 2020, scheme: "https"],
	http: [
	port: 8080,
	ip: {127, 0, 0, 1}
	]
	```

	This will make Akkoma listen on `127.0.0.1` port `8080` and generate urls starting with `https://example.com:2020`

	### :http_security
	* ``enabled``: Whether the managed content security policy is enabled.
	* ``sts``: Whether to additionally send a `Strict-Transport-Security` header.
	* ``sts_max_age``: The maximum age for the `Strict-Transport-Security` header if sent.
	* ``referrer_policy``: The referrer policy to use, either `"same-origin"` or `"no-referrer"`.
	* ``report_uri``: Adds the specified url to `report-uri` and `report-to` group in CSP header.

	### Pleroma.Web.Plugs.RemoteIp

	!!! warning
	If your instance is not behind at least one reverse proxy, you should not enable this plug.

	`Pleroma.Web.Plugs.RemoteIp` is a shim to call [`RemoteIp`](https://git.pleroma.social/pleroma/remote_ip) but with runtime configuration.

	Available options:

	* `enabled` - Enable/disable the plug. Defaults to `false`.
	* `headers` - A list of strings naming the HTTP headers to use when deriving the true client IP address. Defaults to `["x-forwarded-for"]`.
	* `proxies` - A list of upstream proxy IP subnets in CIDR notation from which we will parse the content of `headers`. Defaults to `[]`. IPv4 entries without a bitmask will be assumed to be /32 and IPv6 /128.
	* `reserved` - A list of reserved IP subnets in CIDR notation which should be ignored if found in `headers`. Defaults to `["127.0.0.0/8", "::1/128", "fc00::/7", "10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16"]`.


	### :rate_limit

	!!! note
	If your instance is behind a reverse proxy ensure [`Pleroma.Web.Plugs.RemoteIp`](#pleroma-plugs-remoteip) is enabled (it is enabled by default).

	A keyword list of rate limiters where a key is a limiter name and value is the limiter configuration. The basic configuration is a tuple where:

	* The first element: `scale` (Integer). The time scale in milliseconds.
	* The second element: `limit` (Integer). How many requests to limit in the time scale provided.

	It is also possible to have different limits for unauthenticated and authenticated users: the keyword value must be a list of two tuples where the first one is a config for unauthenticated users and the second one is for authenticated.

	For example:

	```elixir
	config :pleroma, :rate_limit,
	authentication: {60_000, 15},
	search: [{1000, 10}, {1000, 30}]
	```

	Means that:

	1. In 60 seconds, 15 authentication attempts can be performed from the same IP address.
	2. In 1 second, 10 search requests can be performed from the same IP adress by unauthenticated users, while authenticated users can perform 30 search requests per second.

	Supported rate limiters:

	* `:search` - Account/Status search.
	* `:timeline` - Timeline requests (each timeline has it's own limiter).
	* `:app_account_creation` - Account registration from the API.
	* `:relations_actions` - Following/Unfollowing in general.
	* `:relation_id_action` - Following/Unfollowing for a specific user.
	* `:statuses_actions` - Status actions such as: (un)repeating, (un)favouriting, creating, deleting.
	* `:status_id_action` - (un)Repeating/(un)Favouriting a particular status.
	* `:authentication` - Authentication actions, i.e getting an OAuth token.
	* `:password_reset` - Requesting password reset emails.
	* `:account_confirmation_resend` - Requesting resending account confirmation emails.
	* `:ap_routes` - Requesting statuses via ActivityPub.

	### :web_cache_ttl

	The expiration time for the web responses cache. Values should be in milliseconds or `nil` to disable expiration.

	Available caches:

	* `:activity_pub` - activity pub routes (except question activities). Defaults to `nil` (no expiration).
	* `:activity_pub_question` - activity pub routes (question activities). Defaults to `30_000` (30 seconds).

	## HTTP client

	### :http

	* `receive_timeout`: the amount of time, in ms, to wait for a remote server to respond to a request. (default: `15000`)
	* `pool_timeout`: the amount of time, in ms, to wait to check out an HTTP connection from the pool. This likely does not need changing unless your instance is _very_ busy with outbound requests. (default `5000`)
	* `proxy_url`: an upstream proxy to fetch posts and/or media with, (default: `nil`); for example `http://127.0.0.1:3192`. Does not support SOCKS5 proxy, only http(s).
	* `send_user_agent`: should we include a user agent with HTTP requests? (default: `true`)
	* `user_agent`: what user agent should we use? (default: `:default`), must be string or `:default`
	* `adapter`: array of adapter options

	## Captcha

	### Pleroma.Captcha

	* `enabled`: Whether the captcha should be shown on registration.
	* `method`: The method/service to use for captcha.
	* `seconds_valid`: The time in seconds for which the captcha is valid.

	### Captcha providers

	#### Pleroma.Captcha.Native

	A built-in captcha provider. Enabled by default.

	#### Pleroma.Captcha.Kocaptcha

	Kocaptcha is a very simple captcha service with a single API endpoint,
	the source code is here: [kocaptcha](https://github.com/koto-bank/kocaptcha). The default endpoint
	`https://captcha.kotobank.ch` is hosted by the developer.

	* `endpoint`: the Kocaptcha endpoint to use.

	## Uploads

	### Pleroma.Upload

	* `uploader`: Which one of the [uploaders](#uploaders) to use.
	* `filters`: List of [upload filters](#upload-filters) to use.
	* `link_name`: When enabled Akkoma will add a `name` parameter to the url of the upload, for example `https://instance.tld/media/corndog.png?name=corndog.png`. This is needed to provide the correct filename in Content-Disposition headers
	* `base_url`: The base URL to access a user-uploaded file; MUST be configured explicitly.
	Using a (sub)domain distinct from the instance endpoint is strongly recommended. A good value might be `https://media.myakkoma.instance/media/`.
	* `proxy_remote`: If you're using a remote uploader, Akkoma will proxy media requests instead of redirecting to it.
	* `proxy_opts`: Proxy options, see `Pleroma.ReverseProxy` documentation.
	* `filename_display_max_length`: Set max length of a filename to display. 0 = no limit. Default: 30.

	!!! warning
	`strip_exif` has been replaced by `Pleroma.Upload.Filter.Mogrify`.

	### Uploaders

	#### Pleroma.Uploaders.Local

	* `uploads`: Which directory to store the user-uploads in, relative to pleroma’s working directory.

	#### Pleroma.Uploaders.S3

	Don't forget to configure [Ex AWS S3](#ex-aws-s3-settings)

	* `bucket`: S3 bucket name.
	* `bucket_namespace`: S3 bucket namespace.
	* `truncated_namespace`: If you use S3 compatible service such as Digital Ocean Spaces or CDN, set folder name or "" etc.
	* `streaming_enabled`: Enable streaming uploads, when enabled the file will be sent to the server in chunks as it's being read. This may be unsupported by some providers, try disabling this if you have upload problems.

	#### Ex AWS S3 settings

	* `access_key_id`: Access key ID
	* `secret_access_key`: Secret access key
	* `host`: S3 host

	Example:

	```elixir
	config :ex_aws, :s3,
	access_key_id: "xxxxxxxxxx",
	secret_access_key: "yyyyyyyyyy",
	host: "s3.eu-central-1.amazonaws.com"
	```

	### Upload filters

	#### Pleroma.Upload.Filter.Dedupe

	Always active; cannot be turned off.
	Renames files to their hash and prevents duplicate files filling up the disk.
	No specific configuration.

	#### Pleroma.Upload.Filter.AnonymizeFilename

	This filter replaces the declared filename (not the path) of an upload.

	* `text`: Text to replace filenames in links. If empty, `{random}.extension` will be used. You can get the original filename extension by using `{extension}`, for example `custom-file-name.{extension}`.

	-#### Pleroma.Upload.Filter.Exiftool
	+#### Pleroma.Upload.Filter.Exiftool.StripMetadata

	This filter only strips the GPS and location metadata with Exiftool leaving color profiles and attributes intact.

	No specific configuration.

	+
	+#### Pleroma.Upload.Filter.Exiftool.ReadDescription
	+
	+This filter reads the ImageDescription and iptc:Caption-Abstract fields with Exiftool so clients can prefill the media description field.
	+
	+No specific configuration.
	+
	#### Pleroma.Upload.Filter.OnlyMedia

	This filter rejects uploads that are not identified with Content-Type matching audio/\, image/\, or video/\*

	No specific configuration.

	#### Pleroma.Upload.Filter.Mogrify

	* `args`: List of actions for the `mogrify` command like `"strip"` or `["strip", "auto-orient", {"implode", "1"}]`.

	## Email

	### Pleroma.Emails.Mailer
	* `adapter`: one of the mail adapters listed in [Swoosh readme](https://github.com/swoosh/swoosh#adapters), or `Swoosh.Adapters.Local` for in-memory mailbox.
	* `api_key` / `password` and / or other adapter-specific settings, per the above documentation.
	* `enabled`: Allows enable/disable send emails. Default: `false`.

	An example for Sendgrid adapter:

	```elixir
	config :pleroma, Pleroma.Emails.Mailer,
	enabled: true,
	adapter: Swoosh.Adapters.Sendgrid,
	api_key: "YOUR_API_KEY"
	```

	An example for SMTP adapter:

	```elixir
	config :pleroma, Pleroma.Emails.Mailer,
	enabled: true,
	adapter: Swoosh.Adapters.SMTP,
	relay: "smtp.gmail.com",
	username: "YOUR_USERNAME@gmail.com",
	password: "YOUR_SMTP_PASSWORD",
	port: 465,
	ssl: true,
	auth: :always
	```

	### :email_notifications

	Email notifications settings.

	- digest - emails of "what you've missed" for users who have been
	inactive for a while.
	- active: globally enable or disable digest emails
	- schedule: When to send digest email, in [crontab format](https://en.wikipedia.org/wiki/Cron).
	"0 0 * * 0" is the default, meaning "once a week at midnight on Sunday morning"
	- interval: Minimum interval between digest emails to one user
	- inactivity_threshold: Minimum user inactivity threshold

	### Pleroma.Emails.UserEmail

	- `:logo` - a path to a custom logo. Set it to `nil` to use the default Akkoma logo.
	- `:styling` - a map with color settings for email templates.

	### Pleroma.Emails.NewUsersDigestEmail

	- `:enabled` - a boolean, enables new users admin digest email when `true`. Defaults to `false`.

	## Background jobs

	### Oban

	[Oban](https://github.com/sorentwo/oban) asynchronous job processor configuration.

	Configuration options described in [Oban readme](https://github.com/sorentwo/oban#usage):

	* `repo` - app's Ecto repo (`Pleroma.Repo`)
	* `log` - logs verbosity
	* `queues` - job queues (see below)
	* `crontab` - periodic jobs, see [`Oban.Cron`](#obancron)

	Akkoma has the following queues:

	* `activity_expiration` - Activity expiration
	* `federator_outgoing` - Outgoing federation
	* `federator_incoming` - Incoming federation
	* `mailer` - Email sender, see [`Pleroma.Emails.Mailer`](#pleromaemailsmailer)
	* `transmogrifier` - Transmogrifier
	* `web_push` - Web push notifications
	* `scheduled_activities` - Scheduled activities, see [`Pleroma.ScheduledActivity`](#pleromascheduledactivity)

	#### Oban.Cron

	Akkoma has these periodic job workers:

	* `Pleroma.Workers.Cron.DigestEmailsWorker` - digest emails for users with new mentions and follows
	* `Pleroma.Workers.Cron.NewUsersDigestWorker` - digest emails for admins with new registrations

	```elixir
	config :pleroma, Oban,
	repo: Pleroma.Repo,
	verbose: false,
	prune: {:maxlen, 1500},
	queues: [
	federator_incoming: 50,
	federator_outgoing: 50
	],
	crontab: [
	{"0 0 * * 0", Pleroma.Workers.Cron.DigestEmailsWorker},
	{"0 0 * * *", Pleroma.Workers.Cron.NewUsersDigestWorker}
	]
	```

	This config contains two queues: `federator_incoming` and `federator_outgoing`. Both have the number of max concurrent jobs set to `50`.

	#### Migrating `pleroma_job_queue` settings

	`config :pleroma_job_queue, :queues` is replaced by `config :pleroma, Oban, :queues` and uses the same format (keys are queues' names, values are max concurrent jobs numbers).

	### :workers

	Includes custom worker options not interpretable directly by `Oban`.

	* `retries` — keyword lists where keys are `Oban` queues (see above) and values are numbers of max attempts for failed jobs.

	Example:

	```elixir
	config :pleroma, :workers,
	retries: [
	federator_incoming: 5,
	federator_outgoing: 5
	]
	```

	#### Migrating `Pleroma.Web.Federator.RetryQueue` settings

	* `max_retries` is replaced with `config :pleroma, :workers, retries: [federator_outgoing: 5]`
	* `enabled: false` corresponds to `config :pleroma, :workers, retries: [federator_outgoing: 1]`
	* deprecated options: `max_jobs`, `initial_timeout`

	## :web_push_encryption, :vapid_details

	Web Push Notifications configuration. You can use the mix task `mix web_push.gen.keypair` to generate it.

	* ``subject``: a mailto link for the administrative contact. It’s best if this email is not a personal email address, but rather a group email so that if a person leaves an organization, is unavailable for an extended period, or otherwise can’t respond, someone else on the list can.
	* ``public_key``: VAPID public key
	* ``private_key``: VAPID private key

	## :logger
	* `backends`: `:console` is used to send logs to stdout, `{ExSyslogger, :ex_syslogger}` to log to syslog, and `Quack.Logger` to log to Slack

	An example to enable ONLY ExSyslogger (f/ex in ``prod.secret.exs``) with info and debug suppressed:
	```elixir
	config :logger,
	backends: [{ExSyslogger, :ex_syslogger}]

	config :logger, :ex_syslogger,
	level: :warn
	```

	Another example, keeping console output and adding the pid to syslog output:
	```elixir
	config :logger,
	backends: [:console, {ExSyslogger, :ex_syslogger}]

	config :logger, :ex_syslogger,
	level: :warn,
	option: [:pid, :ndelay]
	```

	See: [logger’s documentation](https://hexdocs.pm/logger/Logger.html) and [ex_syslogger’s documentation](https://hexdocs.pm/ex_syslogger/)

	An example of logging info to local syslog, but warn to a Slack channel:
	```elixir
	config :logger,
	backends: [ {ExSyslogger, :ex_syslogger}, Quack.Logger ],
	level: :info

	config :logger, :ex_syslogger,
	level: :info,
	ident: "pleroma",
	format: "$metadata[$level] $message"
	```

	## Database options

	### RUM indexing for full text search

	!!! warning
	It is recommended to use PostgreSQL v11 or newer. We have seen some minor issues with lower PostgreSQL versions.

	* `rum_enabled`: If RUM indexes should be used. Defaults to `false`.

	RUM indexes are an alternative indexing scheme that is not included in PostgreSQL by default. While they may eventually be mainlined, for now they have to be installed as a PostgreSQL extension from https://github.com/postgrespro/rum.

	Their advantage over the standard GIN indexes is that they allow efficient ordering of search results by timestamp, which makes search queries a lot faster on larger servers, by one or two orders of magnitude. They take up around 3 times as much space as GIN indexes.

	To enable them, both the `rum_enabled` flag has to be set and the following special migration has to be run:

	`mix ecto.migrate --migrations-path priv/repo/optional_migrations/rum_indexing/`

	This will probably take a long time.

	## Authentication

	### :admin_token

	Allows to set a token that can be used to authenticate with the admin api without using an actual user by giving it as the `admin_token` parameter or `x-admin-token` HTTP header. Example:

	```elixir
	config :pleroma, :admin_token, "somerandomtoken"
	```

	You can then do

	```shell
	curl "http://localhost:4000/api/v1/pleroma/admin/users/invites?admin_token=somerandomtoken"
	```

	or

	```shell
	curl -H "X-Admin-Token: somerandomtoken" "http://localhost:4000/api/v1/pleroma/admin/users/invites"
	```

	Warning: it's discouraged to use this feature because of the associated security risk: static / rarely changed instance-wide token is much weaker compared to email-password pair of a real admin user; consider using HTTP Basic Auth or OAuth-based authentication instead.

	### :auth

	Authentication / authorization settings.

	* `auth_template`: authentication form template. By default it's `show.html` which corresponds to `lib/pleroma/web/templates/o_auth/o_auth/show.html.eex`.
	* `oauth_consumer_template`: OAuth consumer mode authentication form template. By default it's `consumer.html` which corresponds to `lib/pleroma/web/templates/o_auth/o_auth/consumer.html.eex`.
	* `oauth_consumer_strategies`: the list of enabled OAuth consumer strategies; by default it's set by `OAUTH_CONSUMER_STRATEGIES` environment variable. Each entry in this space-delimited string should be of format `<strategy>` or `<strategy>:<dependency>` (e.g. `twitter` or `keycloak:ueberauth_keycloak_strategy` in case dependency is named differently than `ueberauth_<strategy>`).

	### Pleroma.Web.Auth.Authenticator

	* `Pleroma.Web.Auth.PleromaAuthenticator`: default database authenticator.
	* `Pleroma.Web.Auth.LDAPAuthenticator`: LDAP authentication.

	### :ldap

	Use LDAP for user authentication. When a user logs in to the Akkoma
	instance, the name and password will be verified by trying to authenticate
	(bind) to an LDAP server. If a user exists in the LDAP directory but there
	is no account with the same name yet on the Akkoma instance then a new
	Akkoma account will be created with the same name as the LDAP user name.

	* `enabled`: enables LDAP authentication
	* `host`: LDAP server hostname
	* `port`: LDAP port, e.g. 389 or 636
	* `ssl`: true to use SSL, usually implies the port 636
	* `sslopts`: additional SSL options
	* `tls`: true to start TLS, usually implies the port 389
	* `tlsopts`: additional TLS options
	* `base`: LDAP base, e.g. "dc=example,dc=com"
	* `uid`: LDAP attribute name to authenticate the user, e.g. when "cn", the filter will be "cn=username,base"

	Note, if your LDAP server is an Active Directory server the correct value is commonly `uid: "cn"`, but if you use an
	OpenLDAP server the value may be `uid: "uid"`.

	### :oauth2 (Akkoma as OAuth 2.0 provider settings)

	OAuth 2.0 provider settings:

	* `token_expires_in` - The lifetime in seconds of the access token.
	* `issue_new_refresh_token` - Keeps old refresh token or generate new refresh token when to obtain an access token.
	* `clean_expired_tokens` - Enable a background job to clean expired oauth tokens. Defaults to `false`.

	OAuth 2.0 provider and related endpoints:

	* `POST /api/v1/apps` creates client app basing on provided params.
	* `GET/POST /oauth/authorize` renders/submits authorization form.
	* `POST /oauth/token` creates/renews OAuth token.
	* `POST /oauth/revoke` revokes provided OAuth token.
	* `GET /api/v1/accounts/verify_credentials` (with proper `Authorization` header or `access_token` URI param) returns user info on requester (with `acct` field containing local nickname and `fqn` field containing fully-qualified nickname which could generally be used as email stub for OAuth software that demands email field in identity endpoint response, like Peertube).

	### OAuth consumer mode

	OAuth consumer mode allows sign in / sign up via external OAuth providers (e.g. Twitter, Facebook, Google, Microsoft, etc.).
	Implementation is based on Ueberauth; see the list of [available strategies](https://github.com/ueberauth/ueberauth/wiki/List-of-Strategies).

	!!! note
	Each strategy is shipped as a separate dependency; in order to get the strategies, run `OAUTH_CONSUMER_STRATEGIES="..." mix deps.get`, e.g. `OAUTH_CONSUMER_STRATEGIES="twitter facebook google microsoft" mix deps.get`. The server should also be started with `OAUTH_CONSUMER_STRATEGIES="..." mix phx.server` in case you enable any strategies.

	!!! note
	Each strategy requires separate setup (on external provider side and Akkoma side). Below are the guidelines on setting up most popular strategies.

	!!! note
	Make sure that `"SameSite=Lax"` is set in `extra_cookie_attrs` when you have this feature enabled. OAuth consumer mode will not work with `"SameSite=Strict"`

	* For Twitter, [register an app](https://developer.twitter.com/en/apps), configure callback URL to https://<your_host>/oauth/twitter/callback

	* For Facebook, [register an app](https://developers.facebook.com/apps), configure callback URL to https://<your_host>/oauth/facebook/callback, enable Facebook Login service at https://developers.facebook.com/apps/<app_id>/fb-login/settings/

	* For Google, [register an app](https://console.developers.google.com), configure callback URL to https://<your_host>/oauth/google/callback

	* For Microsoft, [register an app](https://portal.azure.com), configure callback URL to https://<your_host>/oauth/microsoft/callback

	Once the app is configured on external OAuth provider side, add app's credentials and strategy-specific settings (if any — e.g. see Microsoft below) to `config/prod.secret.exs`,
	per strategy's documentation (e.g. [ueberauth_twitter](https://github.com/ueberauth/ueberauth_twitter)). Example config basing on environment variables:

	```elixir
	# Twitter
	config :ueberauth, Ueberauth.Strategy.Twitter.OAuth,
	consumer_key: System.get_env("TWITTER_CONSUMER_KEY"),
	consumer_secret: System.get_env("TWITTER_CONSUMER_SECRET")

	# Facebook
	config :ueberauth, Ueberauth.Strategy.Facebook.OAuth,
	client_id: System.get_env("FACEBOOK_APP_ID"),
	client_secret: System.get_env("FACEBOOK_APP_SECRET"),
	redirect_uri: System.get_env("FACEBOOK_REDIRECT_URI")

	# Google
	config :ueberauth, Ueberauth.Strategy.Google.OAuth,
	client_id: System.get_env("GOOGLE_CLIENT_ID"),
	client_secret: System.get_env("GOOGLE_CLIENT_SECRET"),
	redirect_uri: System.get_env("GOOGLE_REDIRECT_URI")

	# Microsoft
	config :ueberauth, Ueberauth.Strategy.Microsoft.OAuth,
	client_id: System.get_env("MICROSOFT_CLIENT_ID"),
	client_secret: System.get_env("MICROSOFT_CLIENT_SECRET")

	config :ueberauth, Ueberauth,
	providers: [
	microsoft: {Ueberauth.Strategy.Microsoft, [callback_params: []]}
	]

	# Keycloak
	# Note: make sure to add `keycloak:ueberauth_keycloak_strategy` entry to `OAUTH_CONSUMER_STRATEGIES` environment variable
	keycloak_url = "https://publicly-reachable-keycloak-instance.org:8080"

	config :ueberauth, Ueberauth.Strategy.Keycloak.OAuth,
	client_id: System.get_env("KEYCLOAK_CLIENT_ID"),
	client_secret: System.get_env("KEYCLOAK_CLIENT_SECRET"),
	site: keycloak_url,
	authorize_url: "#{keycloak_url}/auth/realms/master/protocol/openid-connect/auth",
	token_url: "#{keycloak_url}/auth/realms/master/protocol/openid-connect/token",
	userinfo_url: "#{keycloak_url}/auth/realms/master/protocol/openid-connect/userinfo",
	token_method: :post

	config :ueberauth, Ueberauth,
	providers: [
	keycloak: {Ueberauth.Strategy.Keycloak, [uid_field: :email]}
	]
	```

	You may also need to set up your frontend to use oauth logins. For example, for `akkoma-fe`:

	```elixir
	config :pleroma, :frontend_configurations,
	pleroma_fe: %{
	loginMethod: "token"
	}
	```

	## Link parsing

	### :uri_schemes
	* `valid_schemes`: List of the scheme part that is considered valid to be an URL.

	### Pleroma.Formatter

	Configuration for Akkoma's link formatter which parses mentions, hashtags, and URLs.

	* `class` - specify the class to be added to the generated link (default: `false`)
	* `rel` - specify the rel attribute (default: `ugc`)
	* `new_window` - adds `target="_blank"` attribute (default: `false`)
	* `truncate` - Set to a number to truncate URLs longer then the number. Truncated URLs will end in `...` (default: `false`)
	* `strip_prefix` - Strip the scheme prefix (default: `false`)
	* `extra` - link URLs with rarely used schemes (magnet, ipfs, irc, etc.) (default: `true`)
	* `validate_tld` - Set to false to disable TLD validation for URLs/emails. Can be set to :no_scheme to validate TLDs only for urls without a scheme (e.g `example.com` will be validated, but `http://example.loki` won't) (default: `:no_scheme`)

	Example:

	```elixir
	config :pleroma, Pleroma.Formatter,
	class: false,
	rel: "ugc",
	new_window: false,
	truncate: false,
	strip_prefix: false,
	extra: true,
	validate_tld: :no_scheme
	```

	## Custom Runtime Modules (`:modules`)

	* `runtime_dir`: A path to custom Elixir modules, such as MRF policies or
	custom authenticators. These modules will be loaded on boot, and can be
	contained in subdirectories. It is advised to use version-controlled
	subdirectories to make management of them a bit easier. Note that only
	files with the extension `.ex` will be loaded.

	```elixir
	config :pleroma, :modules, runtime_dir: "instance/modules"
	```

	### Adding a module

	```bash
	cd instance/modules/
	git clone <MY MODULE>
	```

	## :configurable_from_database

	Boolean, enables/disables in-database configuration. Read [Transfering the config to/from the database](../administration/CLI_tasks/config.md) for more information.

	## :database_config_whitelist

	List of valid configuration sections which are allowed to be configured from the
	database. Settings stored in the database before the whitelist is configured are
	still applied, so it is suggested to only use the whitelist on instances that
	have not migrated the config to the database.

	Example:
	```elixir
	config :pleroma, :database_config_whitelist, [
	{:pleroma, :instance},
	{:pleroma, Pleroma.Web.Metadata},
	{:auto_linker}
	]
	```

	### Multi-factor authentication - :two_factor_authentication
	* `totp` - a list containing TOTP configuration
	- `digits` - Determines the length of a one-time pass-code in characters. Defaults to 6 characters.
	- `period` - a period for which the TOTP code will be valid in seconds. Defaults to 30 seconds.
	* `backup_codes` - a list containing backup codes configuration
	- `number` - number of backup codes to generate.
	- `length` - backup code length. Defaults to 16 characters.

	## Restrict entities access for unauthenticated users

	### :restrict_unauthenticated

	Restrict access for unauthenticated users to timelines (public and federated), user profiles and posts.

	* `timelines`: public and federated timelines
	* `local`: public timeline
	* `federated`: federated timeline (includes public timeline)
	* `profiles`: user profiles
	* `local`
	* `remote`
	* `activities`: posts
	* `local`
	* `remote`

	#### When :instance, :public is `true`

	When your instance is in "public" mode, all public resources (users, posts, timelines) are accessible to unauthenticated users.

	Turning any of the `:restrict_unauthenticated` options to `true` will restrict access to the corresponding resources.

	#### When :instance, :public is `false`

	When `:instance, :public` is set to `false`, all of the `:restrict_unauthenticated` options will effectively be set to `true` by default,
	meaning that only authenticated users will be able to access the corresponding resources.

	If you'd like to allow unauthenticated access to specific resources, you can turn these settings to `false`.

	Note: setting `restrict_unauthenticated/timelines/local` to `true` has no practical sense if `restrict_unauthenticated/timelines/federated` is set to `false` (since local public activities will still be delivered to unauthenticated users as part of federated timeline).

	## Pleroma.Web.ApiSpec.CastAndValidate

	* `:strict` a boolean, enables strict input validation (useful in development, not recommended in production). Defaults to `false`.

	## :instances_favicons

	Control favicons for instances.

	* `enabled`: Allow/disallow displaying and getting instances favicons

	## Pleroma.User.Backup

	!!! note
	Requires enabled email

	* `:purge_after_days` an integer, remove backup achives after N days.
	* `:limit_days` an integer, limit user to export not more often than once per N days.
	* `:dir` a string with a path to backup temporary directory or `nil` to let Akkoma choose temporary directory in the following order:
	1. the directory named by the TMPDIR environment variable
	2. the directory named by the TEMP environment variable
	3. the directory named by the TMP environment variable
	4. C:\TMP on Windows or /tmp on Unix-like operating systems
	5. as a last resort, the current working directory

	### Theme settings

	Settings to change theme as exposed to the outside world, for software
	that scans `index.html` (mainly misskey)

	```
	config :pleroma, Pleroma.Web.Metadata.Providers.Theme, theme_color: "#593196"
	```

	This sets the `theme-color` meta tag on `index.html`, and is basically
	a hack to make misskey find the right thing.

	## Ephemeral activities (Pleroma.Workers.PurgeExpiredActivity)

	Settings to enable and configure expiration for ephemeral activities

	* `:enabled` - enables ephemeral activities creation
	* `:min_lifetime` - minimum lifetime for ephemeral activities (in seconds). Default: 10 minutes.

	## ConcurrentLimiter

	Settings to restrict concurrently running jobs. Jobs which can be configured:

	* `Pleroma.Web.RichMedia.Helpers` - generating link previews of URLs in activities
	* `Pleroma.Web.ActivityPub.MRF.MediaProxyWarmingPolicy` - warming remote media cache via MediaProxyWarmingPolicy

	Each job has these settings:

	* `:max_running` - max concurrently runnings jobs
	* `:max_waiting` - max waiting jobs

	### Translation Settings

	Settings to automatically translate statuses for end users. Currently supported
	translation services are DeepL and LibreTranslate. The supported command line tool is [Argos Translate](https://github.com/argosopentech/argos-translate).

	Translations are available at `/api/v1/statuses/:id/translations/:language`, where
	`language` is the target language code (e.g `en`)

	### `:translator`

	- `:enabled` - enables translation
	- `:module` - Sets module to be used
	- Either `Pleroma.Akkoma.Translators.DeepL`, `Pleroma.Akkoma.Translators.LibreTranslate`, or `Pleroma.Akkoma.Translators.ArgosTranslate`

	### `:deepl`

	- `:api_key` - API key for DeepL
	- `:tier` - API tier
	- either `:free` or `:pro`

	### `:libre_translate`

	- `:url` - URL of LibreTranslate instance
	- `:api_key` - API key for LibreTranslate

	### `:argos_translate`

	- `:command_argos_translate` - command for `argos-translate`. Can be the command if it's in your PATH, or the full path to the file (default: `argos-translate`).
	- `:command_argospm` - command for `argospm`. Can be the command if it's in your PATH, or the full path to the file (default: `argospm`).
	- `:strip_html` - Strip html from the post before translating it (default: `true`).
	diff --git a/docs/docs/installation/optional/media_graphics_packages.md b/docs/docs/installation/optional/media_graphics_packages.md
	index ab9f958f9..d79ac2a07 100644
	--- a/docs/docs/installation/optional/media_graphics_packages.md
	+++ b/docs/docs/installation/optional/media_graphics_packages.md
	@@ -1,32 +1,33 @@
	# Optional software packages needed for specific functionality

	For specific Akkoma functionality (which is disabled by default) some or all of the below packages are required:
	* `ImageMagick`
	* `ffmpeg`
	* `exiftool`

	Please refer to documentation in `docs/installation` on how to install them on specific OS.

	Note: the packages are not required with the current default settings of Akkoma.

	## `ImageMagick`

	`ImageMagick` is a set of tools to create, edit, compose, or convert bitmap images.

	It is required for the following Akkoma features:
	* `Pleroma.Upload.Filters.Mogrify`, `Pleroma.Upload.Filters.Mogrifun` upload filters (related config: `Plaroma.Upload/filters` in `config/config.exs`)
	* Media preview proxy for still images (related config: `media_preview_proxy/enabled` in `config/config.exs`)

	## `ffmpeg`

	`ffmpeg` is software to record, convert and stream audio and video.

	It is required for the following Akkoma features:
	* Media preview proxy for videos (related config: `media_preview_proxy/enabled` in `config/config.exs`)

	## `exiftool`

	`exiftool` is media files metadata reader/writer.

	It is required for the following Akkoma features:
	- * `Pleroma.Upload.Filters.Exiftool` upload filter (related config: `Plaroma.Upload/filters` in `config/config.exs`)
	+ * `Pleroma.Upload.Filters.Exiftool.StripMetadata` upload filter (related config: `Plaroma.Upload/filters` in `config/config.exs`)
	+ * `Pleroma.Upload.Filters.Exiftool.ReadDescription` upload filter (related config: `Plaroma.Upload/filters` in `config/config.exs`)
	diff --git a/lib/mix/tasks/pleroma/instance.ex b/lib/mix/tasks/pleroma/instance.ex
	index 44f6b6e70..c02efabae 100644
	--- a/lib/mix/tasks/pleroma/instance.ex
	+++ b/lib/mix/tasks/pleroma/instance.ex
	@@ -1,324 +1,352 @@
	# Pleroma: A lightweight social networking server
	# Copyright © 2017-2021 Pleroma Authors <https://pleroma.social/>
	# SPDX-License-Identifier: AGPL-3.0-only

	defmodule Mix.Tasks.Pleroma.Instance do
	use Mix.Task
	import Mix.Pleroma

	alias Pleroma.Config

	@shortdoc "Manages Pleroma instance"
	@moduledoc File.read!("docs/docs/administration/CLI_tasks/instance.md")

	def run(["gen" \| rest]) do
	{options, [], []} =
	OptionParser.parse(
	rest,
	strict: [
	force: :boolean,
	output: :string,
	output_psql: :string,
	domain: :string,
	media_url: :string,
	instance_name: :string,
	admin_email: :string,
	notify_email: :string,
	dbhost: :string,
	dbname: :string,
	dbuser: :string,
	dbpass: :string,
	rum: :string,
	indexable: :string,
	db_configurable: :string,
	uploads_dir: :string,
	static_dir: :string,
	listen_ip: :string,
	listen_port: :string,
	- strip_uploads: :string,
	+ strip_uploads_metadata: :string,
	+ read_uploads_description: :string,
	anonymize_uploads: :string
	],
	aliases: [
	o: :output,
	f: :force
	]
	)

	paths =
	[config_path, psql_path] = [
	Keyword.get(options, :output, "config/generated_config.exs"),
	Keyword.get(options, :output_psql, "config/setup_db.psql")
	]

	will_overwrite = Enum.filter(paths, &File.exists?/1)
	proceed? = Enum.empty?(will_overwrite) or Keyword.get(options, :force, false)

	if proceed? do
	[domain, port \| _] =
	String.split(
	get_option(
	options,
	:domain,
	"What domain will your instance use? (e.g akkoma.example.com)"
	),
	":"
	) ++ [443]

	media_url =
	get_option(
	options,
	:media_url,
	"What base url will uploads use? (e.g https://media.example.com/media)\n" <>
	" Generally this should NOT use the same domain as the instance "
	)

	name =
	get_option(
	options,
	:instance_name,
	"What is the name of your instance? (e.g. The Corndog Emporium)",
	domain
	)

	email = get_option(options, :admin_email, "What is your admin email address?")

	notify_email =
	get_option(
	options,
	:notify_email,
	"What email address do you want to use for sending email notifications?",
	email
	)

	indexable =
	get_option(
	options,
	:indexable,
	"Do you want search engines to index your site? (y/n)",
	"y"
	) === "y"

	db_configurable? =
	get_option(
	options,
	:db_configurable,
	"Do you want to store the configuration in the database (allows controlling it from admin-fe)? (y/n)",
	"n"
	) === "y"

	dbhost = get_option(options, :dbhost, "What is the hostname of your database?", "localhost")

	dbname = get_option(options, :dbname, "What is the name of your database?", "akkoma")

	dbuser =
	get_option(
	options,
	:dbuser,
	"What is the user used to connect to your database?",
	"akkoma"
	)

	dbpass =
	get_option(
	options,
	:dbpass,
	"What is the password used to connect to your database?",
	:crypto.strong_rand_bytes(64) \|> Base.encode64() \|> binary_part(0, 64),
	"autogenerated"
	)

	rum_enabled =
	get_option(
	options,
	:rum,
	"Would you like to use RUM indices?",
	"n"
	) === "y"

	listen_port =
	get_option(
	options,
	:listen_port,
	"What port will the app listen to (leave it if you are using the default setup with nginx)?",
	4000
	)

	listen_ip =
	get_option(
	options,
	:listen_ip,
	"What ip will the app listen to (leave it if you are using the default setup with nginx)?",
	"127.0.0.1"
	)

	uploads_dir =
	get_option(
	options,
	:uploads_dir,
	"What directory should media uploads go in (when using the local uploader)?",
	Config.get([Pleroma.Uploaders.Local, :uploads])
	)
	\|> Path.expand()

	static_dir =
	get_option(
	options,
	:static_dir,
	"What directory should custom public files be read from (custom emojis, frontend bundle overrides, robots.txt, etc.)?",
	Config.get([:instance, :static_dir])
	)
	\|> Path.expand()

	- {strip_uploads_message, strip_uploads_default} =
	+ {strip_uploads_metadata_message, strip_uploads_metadata_default} =
	if Pleroma.Utils.command_available?("exiftool") do
	{"Do you want to strip location (GPS) data from uploaded images? This requires exiftool, it was detected as installed. (y/n)",
	"y"}
	else
	{"Do you want to strip location (GPS) data from uploaded images? This requires exiftool, it was detected as not installed, please install it if you answer yes. (y/n)",
	"n"}
	end

	- strip_uploads =
	+ strip_uploads_metadata =
	get_option(
	options,
	- :strip_uploads,
	- strip_uploads_message,
	- strip_uploads_default
	+ :strip_uploads_metadata,
	+ strip_uploads_metadata_message,
	+ strip_uploads_metadata_default
	+ ) === "y"
	+
	+ {read_uploads_description_message, read_uploads_description_default} =
	+ if Pleroma.Utils.command_available?("exiftool") do
	+ {"Do you want to read data from uploaded files so clients can use it to prefill fields like image description? This requires exiftool, it was detected as installed. (y/n)",
	+ "y"}
	+ else
	+ {"Do you want to read data from uploaded files so clients can use it to prefill fields like image description? This requires exiftool, it was detected as not installed, please install it if you answer yes. (y/n)",
	+ "n"}
	+ end
	+
	+ read_uploads_description =
	+ get_option(
	+ options,
	+ :read_uploads_description,
	+ read_uploads_description_message,
	+ read_uploads_description_default
	) === "y"

	anonymize_uploads =
	get_option(
	options,
	:anonymize_uploads,
	"Do you want to anonymize the filenames of uploads? (y/n)",
	"n"
	) === "y"

	Config.put([:instance, :static_dir], static_dir)

	secret = :crypto.strong_rand_bytes(64) \|> Base.encode64() \|> binary_part(0, 64)
	jwt_secret = :crypto.strong_rand_bytes(64) \|> Base.encode64() \|> binary_part(0, 64)
	signing_salt = :crypto.strong_rand_bytes(8) \|> Base.encode64() \|> binary_part(0, 8)
	lv_signing_salt = :crypto.strong_rand_bytes(8) \|> Base.encode64() \|> binary_part(0, 8)
	{web_push_public_key, web_push_private_key} = :crypto.generate_key(:ecdh, :prime256v1)
	template_dir = Application.app_dir(:pleroma, "priv") <> "/templates"

	result_config =
	EEx.eval_file(
	template_dir <> "/sample_config.eex",
	domain: domain,
	media_url: media_url,
	port: port,
	email: email,
	notify_email: notify_email,
	name: name,
	dbhost: dbhost,
	dbname: dbname,
	dbuser: dbuser,
	dbpass: dbpass,
	secret: secret,
	jwt_secret: jwt_secret,
	signing_salt: signing_salt,
	lv_signing_salt: lv_signing_salt,
	web_push_public_key: Base.url_encode64(web_push_public_key, padding: false),
	web_push_private_key: Base.url_encode64(web_push_private_key, padding: false),
	db_configurable?: db_configurable?,
	static_dir: static_dir,
	uploads_dir: uploads_dir,
	rum_enabled: rum_enabled,
	listen_ip: listen_ip,
	listen_port: listen_port,
	upload_filters:
	upload_filters(%{
	- strip: strip_uploads,
	+ strip_metadata: strip_uploads_metadata,
	+ read_description: read_uploads_description,
	anonymize: anonymize_uploads
	})
	)

	result_psql =
	EEx.eval_file(
	template_dir <> "/sample_psql.eex",
	dbname: dbname,
	dbuser: dbuser,
	dbpass: dbpass,
	rum_enabled: rum_enabled
	)

	config_dir = Path.dirname(config_path)
	psql_dir = Path.dirname(psql_path)

	# Note: Distros requiring group read (0o750) on those directories should
	# pre-create the directories.
	to_create =
	[config_dir, psql_dir, static_dir, uploads_dir]
	\|> Enum.reject(&File.exists?/1)

	for dir <- to_create do
	File.mkdir_p!(dir)
	File.chmod!(dir, 0o700)
	end

	shell_info("Writing config to #{config_path}.")

	# Sadly no fchmod(2) equivalent in Elixir…
	File.touch!(config_path)
	File.chmod!(config_path, 0o640)
	File.write(config_path, result_config)
	shell_info("Writing the postgres script to #{psql_path}.")
	File.write(psql_path, result_psql)

	write_robots_txt(static_dir, indexable, template_dir)

	shell_info(
	"\n All files successfully written! Refer to the installation instructions for your platform for next steps."
	)

	if db_configurable? do
	shell_info(
	" Please transfer your config to the database after running database migrations. Refer to \"Transfering the config to/from the database\" section of the docs for more information."
	)
	end
	else
	shell_error(
	"The task would have overwritten the following files:\n" <>
	Enum.map_join(will_overwrite, &"- #{&1}\n") <> "Rerun with `--force` to overwrite them."
	)
	end
	end

	defp write_robots_txt(static_dir, indexable, template_dir) do
	robots_txt =
	EEx.eval_file(
	template_dir <> "/robots_txt.eex",
	indexable: indexable
	)

	robots_txt_path = Path.join(static_dir, "robots.txt")

	if File.exists?(robots_txt_path) do
	File.cp!(robots_txt_path, "#{robots_txt_path}.bak")
	shell_info("Backing up existing robots.txt to #{robots_txt_path}.bak")
	end

	File.write(robots_txt_path, robots_txt)
	shell_info("Writing #{robots_txt_path}.")
	end

	defp upload_filters(filters) when is_map(filters) do
	+ enabled_filters = []
	+
	+ enabled_filters =
	+ if filters.read_description do
	+ enabled_filters ++ [Pleroma.Upload.Filter.Exiftool.ReadDescription]
	+ else
	+ enabled_filters
	+ end
	+
	enabled_filters =
	- if filters.strip do
	- [Pleroma.Upload.Filter.Exiftool]
	+ if filters.strip_metadata do
	+ enabled_filters ++ [Pleroma.Upload.Filter.Exiftool.StripMetadata]
	else
	- []
	+ enabled_filters
	end

	enabled_filters =
	if filters.anonymize do
	enabled_filters ++ [Pleroma.Upload.Filter.AnonymizeFilename]
	else
	enabled_filters
	end

	enabled_filters
	end
	end
	diff --git a/lib/pleroma/application_requirements.ex b/lib/pleroma/application_requirements.ex
	index 8dc269f0f..c3777d8f1 100644
	--- a/lib/pleroma/application_requirements.ex
	+++ b/lib/pleroma/application_requirements.ex
	@@ -1,235 +1,236 @@
	# Pleroma: A lightweight social networking server
	# Copyright © 2017-2021 Pleroma Authors <https://pleroma.social/>
	# SPDX-License-Identifier: AGPL-3.0-only

	defmodule Pleroma.ApplicationRequirements do
	@moduledoc """
	The module represents the collection of validations to runs before start server.
	"""

	defmodule VerifyError, do: defexception([:message])

	alias Pleroma.Config
	alias Pleroma.Helpers.MediaHelper

	import Ecto.Query

	require Logger

	@spec verify!() :: :ok \| VerifyError.t()
	def verify! do
	:ok
	\|> check_system_commands!()
	\|> check_confirmation_accounts!()
	\|> check_migrations_applied!()
	\|> check_welcome_message_config!()
	\|> check_rum!()
	\|> check_repo_pool_size!()
	\|> handle_result()
	end

	defp handle_result(:ok), do: :ok
	defp handle_result({:error, message}), do: raise(VerifyError, message: message)

	defp check_welcome_message_config!(:ok) do
	if Pleroma.Config.get([:welcome, :email, :enabled], false) and
	not Pleroma.Emails.Mailer.enabled?() do
	Logger.warning("""
	To send welcome emails, you need to enable the mailer.
	Welcome emails will NOT be sent with the current config.

	Enable the mailer:
	config :pleroma, Pleroma.Emails.Mailer, enabled: true
	""")
	end

	:ok
	end

	defp check_welcome_message_config!(result), do: result

	# Checks account confirmation email
	#
	def check_confirmation_accounts!(:ok) do
	if Pleroma.Config.get([:instance, :account_activation_required]) &&
	not Pleroma.Emails.Mailer.enabled?() do
	Logger.warning("""
	Account activation is required, but the mailer is disabled.
	Users will NOT be able to confirm their accounts with this config.
	Either disable account activation or enable the mailer.

	Disable account activation:
	config :pleroma, :instance, account_activation_required: false

	Enable the mailer:
	config :pleroma, Pleroma.Emails.Mailer, enabled: true
	""")
	end

	:ok
	end

	def check_confirmation_accounts!(result), do: result

	# Checks for pending migrations.
	#
	def check_migrations_applied!(:ok) do
	unless Pleroma.Config.get(
	[:i_am_aware_this_may_cause_data_loss, :disable_migration_check],
	false
	) do
	{_, res, _} =
	Ecto.Migrator.with_repo(Pleroma.Repo, fn repo ->
	down_migrations =
	Ecto.Migrator.migrations(repo)
	\|> Enum.reject(fn
	{:up, _, _} -> true
	{:down, _, _} -> false
	end)

	if length(down_migrations) > 0 do
	down_migrations_text =
	Enum.map(down_migrations, fn {:down, id, name} -> "- #{name} (#{id})\n" end)

	Logger.error(
	"The following migrations were not applied:\n#{down_migrations_text}" <>
	"If you want to start Pleroma anyway, set\n" <>
	"config :pleroma, :i_am_aware_this_may_cause_data_loss, disable_migration_check: true"
	)

	{:error, "Unapplied Migrations detected"}
	else
	:ok
	end
	end)

	res
	else
	:ok
	end
	end

	def check_migrations_applied!(result), do: result

	# Checks for settings of RUM indexes.
	#
	defp check_rum!(:ok) do
	{_, res, _} =
	Ecto.Migrator.with_repo(Pleroma.Repo, fn repo ->
	migrate =
	from(o in "columns",
	where: o.table_name == "objects",
	where: o.column_name == "fts_content"
	)
	\|> repo.exists?(prefix: "information_schema")

	setting = Pleroma.Config.get([:database, :rum_enabled], false)

	do_check_rum!(setting, migrate)
	end)

	res
	end

	defp check_rum!(result), do: result

	defp do_check_rum!(setting, migrate) do
	case {setting, migrate} do
	{true, false} ->
	Logger.error(
	"Use `RUM` index is enabled, but were not applied migrations for it.\n" <>
	"If you want to start Pleroma anyway, set\n" <>
	"config :pleroma, :database, rum_enabled: false\n" <>
	"Otherwise apply the following migrations:\n" <>
	"`mix ecto.migrate --migrations-path priv/repo/optional_migrations/rum_indexing/`"
	)

	{:error, "Unapplied RUM Migrations detected"}

	{false, true} ->
	Logger.error(
	"Detected applied migrations to use `RUM` index, but `RUM` isn't enable in settings.\n" <>
	"If you want to use `RUM`, set\n" <>
	"config :pleroma, :database, rum_enabled: true\n" <>
	"Otherwise roll `RUM` migrations back.\n" <>
	"`mix ecto.rollback --migrations-path priv/repo/optional_migrations/rum_indexing/`"
	)

	{:error, "RUM Migrations detected"}

	_ ->
	:ok
	end
	end

	defp check_system_commands!(:ok) do
	filter_commands_statuses = [
	- check_filter(Pleroma.Upload.Filter.Exiftool, "exiftool"),
	+ check_filter(Pleroma.Upload.Filter.Exiftool.StripMetadata, "exiftool"),
	+ check_filter(Pleroma.Upload.Filter.Exiftool.ReadDescription, "exiftool"),
	check_filter(Pleroma.Upload.Filter.Mogrify, "mogrify"),
	check_filter(Pleroma.Upload.Filter.Mogrifun, "mogrify"),
	check_filter(Pleroma.Upload.Filter.AnalyzeMetadata, "mogrify"),
	check_filter(Pleroma.Upload.Filter.AnalyzeMetadata, "convert"),
	check_filter(Pleroma.Upload.Filter.AnalyzeMetadata, "ffprobe")
	]

	preview_proxy_commands_status =
	if !Config.get([:media_preview_proxy, :enabled]) or
	MediaHelper.missing_dependencies() == [] do
	true
	else
	Logger.error(
	"The following dependencies required by Media preview proxy " <>
	"(which is currently enabled) are not installed: " <>
	inspect(MediaHelper.missing_dependencies())
	)

	false
	end

	if Enum.all?([preview_proxy_commands_status \| filter_commands_statuses], & &1) do
	:ok
	else
	{:error,
	"System commands missing. Check logs and see `docs/installation` for more details."}
	end
	end

	defp check_repo_pool_size!(:ok) do
	if Pleroma.Config.get([Pleroma.Repo, :pool_size], 10) != 10 and
	not Pleroma.Config.get([:dangerzone, :override_repo_pool_size], false) do
	Logger.error("""
	!!!CONFIG WARNING!!!

	The database pool size has been altered from the recommended value of 10.

	Please revert or ensure your database is tuned appropriately and then set
	`config :pleroma, :dangerzone, override_repo_pool_size: true`.

	If you are experiencing database timeouts, please check the "Optimizing
	your PostgreSQL performance" section in the documentation. If you still
	encounter issues after that, please open an issue on the tracker.
	""")

	{:error, "Repo.pool_size different than recommended value."}
	else
	:ok
	end
	end

	defp check_repo_pool_size!(result), do: result

	defp check_filter(filter, command_required) do
	filters = Config.get([Pleroma.Upload, :filters])

	if filter in filters and not Pleroma.Utils.command_available?(command_required) do
	Logger.error(
	"#{filter} is specified in list of Pleroma.Upload filters, but the " <>
	"#{command_required} command is not found"
	)

	false
	else
	true
	end
	end
	end
	diff --git a/lib/pleroma/config/deprecation_warnings.ex b/lib/pleroma/config/deprecation_warnings.ex
	index c299a4947..b62532595 100644
	--- a/lib/pleroma/config/deprecation_warnings.ex
	+++ b/lib/pleroma/config/deprecation_warnings.ex
	@@ -1,392 +1,430 @@
	# Pleroma: A lightweight social networking server
	# Copyright © 2017-2021 Pleroma Authors <https://pleroma.social/>
	# SPDX-License-Identifier: AGPL-3.0-only

	defmodule Pleroma.Config.DeprecationWarnings do
	alias Pleroma.Config

	require Logger
	alias Pleroma.Config

	@type config_namespace() :: atom() \| [atom()]
	@type config_map() :: {config_namespace(), config_namespace(), String.t()}

	@mrf_config_map [
	{[:instance, :rewrite_policy], [:mrf, :policies],
	"\n* `config :pleroma, :instance, rewrite_policy` is now `config :pleroma, :mrf, policies`"},
	{[:instance, :mrf_transparency], [:mrf, :transparency],
	"\n* `config :pleroma, :instance, mrf_transparency` is now `config :pleroma, :mrf, transparency`"},
	{[:instance, :mrf_transparency_exclusions], [:mrf, :transparency_exclusions],
	"\n* `config :pleroma, :instance, mrf_transparency_exclusions` is now `config :pleroma, :mrf, transparency_exclusions`"},
	{[:instance, :quarantined_instances], [:mrf_simple, :reject],
	"\n* `config :pleroma, :instance, :quarantined_instances` is now covered by `:pleroma, :mrf_simple, :reject`"}
	]

	+ def check_exiftool_filter do
	+ filters = Config.get([Pleroma.Upload]) \|> Keyword.get(:filters, [])
	+
	+ if Pleroma.Upload.Filter.Exiftool in filters do
	+ Logger.warning("""
	+ !!!DEPRECATION WARNING!!!
	+ Your config is using Exiftool as a filter instead of Exiftool.StripMetadata. This should work for now, but you are advised to change to the new configuration to prevent possible issues later:
	+
	+ ```
	+ config :pleroma, Pleroma.Upload,
	+ filters: [Pleroma.Upload.Filter.Exiftool]
	+ ```
	+
	+ Is now
	+
	+
	+ ```
	+ config :pleroma, Pleroma.Upload,
	+ filters: [Pleroma.Upload.Filter.Exiftool.StripMetadata]
	+ ```
	+ """)
	+
	+ new_config =
	+ filters
	+ \|> Enum.map(fn
	+ Pleroma.Upload.Filter.Exiftool -> Pleroma.Upload.Filter.Exiftool.StripMetadata
	+ filter -> filter
	+ end)
	+
	+ Config.put([Pleroma.Upload, :filters], new_config)
	+
	+ :error
	+ else
	+ :ok
	+ end
	+ end
	+
	def check_simple_policy_tuples do
	has_strings =
	Config.get([:mrf_simple])
	\|> Enum.any?(fn {_, v} -> is_list(v) and Enum.any?(v, &is_binary/1) end)

	if has_strings do
	Logger.warning("""
	!!!DEPRECATION WARNING!!!
	Your config is using strings in the SimplePolicy configuration instead of tuples. They should work for now, but you are advised to change to the new configuration to prevent possible issues later:

	```
	config :pleroma, :mrf_simple,
	media_removal: ["instance.tld"],
	media_nsfw: ["instance.tld"],
	federated_timeline_removal: ["instance.tld"],
	report_removal: ["instance.tld"],
	reject: ["instance.tld"],
	followers_only: ["instance.tld"],
	accept: ["instance.tld"],
	avatar_removal: ["instance.tld"],
	banner_removal: ["instance.tld"],
	reject_deletes: ["instance.tld"]
	```

	Is now


	```
	config :pleroma, :mrf_simple,
	media_removal: [{"instance.tld", "Reason for media removal"}],
	media_nsfw: [{"instance.tld", "Reason for media nsfw"}],
	federated_timeline_removal: [{"instance.tld", "Reason for federated timeline removal"}],
	report_removal: [{"instance.tld", "Reason for report removal"}],
	reject: [{"instance.tld", "Reason for reject"}],
	followers_only: [{"instance.tld", "Reason for followers only"}],
	accept: [{"instance.tld", "Reason for accept"}],
	avatar_removal: [{"instance.tld", "Reason for avatar removal"}],
	banner_removal: [{"instance.tld", "Reason for banner removal"}],
	reject_deletes: [{"instance.tld", "Reason for reject deletes"}]
	```
	""")

	new_config =
	Config.get([:mrf_simple])
	\|> Enum.filter(fn {_k, v} -> not is_atom(v) end)
	\|> Enum.map(fn {k, v} ->
	{k,
	Enum.map(v, fn
	{instance, reason} -> {instance, reason}
	instance -> {instance, ""}
	end)}
	end)

	Config.put([:mrf_simple], new_config)

	:error
	else
	:ok
	end
	end

	def check_quarantined_instances_tuples do
	has_strings = Config.get([:instance, :quarantined_instances], []) \|> Enum.any?(&is_binary/1)

	if has_strings do
	Logger.warning("""
	!!!DEPRECATION WARNING!!!
	Your config is using strings in the quarantined_instances configuration instead of tuples. They should work for now, but you are advised to change to the new configuration to prevent possible issues later:

	```
	config :pleroma, :instance,
	quarantined_instances: ["instance.tld"]
	```

	Is now


	```
	config :pleroma, :instance,
	quarantined_instances: [{"instance.tld", "Reason for quarantine"}]
	```
	""")

	new_config =
	Config.get([:instance, :quarantined_instances])
	\|> Enum.map(fn
	{instance, reason} -> {instance, reason}
	instance -> {instance, ""}
	end)

	Config.put([:instance, :quarantined_instances], new_config)

	:error
	else
	:ok
	end
	end

	def check_transparency_exclusions_tuples do
	has_strings = Config.get([:mrf, :transparency_exclusions]) \|> Enum.any?(&is_binary/1)

	if has_strings do
	Logger.warning("""
	!!!DEPRECATION WARNING!!!
	Your config is using strings in the transparency_exclusions configuration instead of tuples. They should work for now, but you are advised to change to the new configuration to prevent possible issues later:

	```
	config :pleroma, :mrf,
	transparency_exclusions: ["instance.tld"]
	```

	Is now


	```
	config :pleroma, :mrf,
	transparency_exclusions: [{"instance.tld", "Reason to exlude transparency"}]
	```
	""")

	new_config =
	Config.get([:mrf, :transparency_exclusions])
	\|> Enum.map(fn
	{instance, reason} -> {instance, reason}
	instance -> {instance, ""}
	end)

	Config.put([:mrf, :transparency_exclusions], new_config)

	:error
	else
	:ok
	end
	end

	def check_hellthread_threshold do
	if Config.get([:mrf_hellthread, :threshold]) do
	Logger.warning("""
	!!!DEPRECATION WARNING!!!
	You are using the old configuration mechanism for the hellthread filter. Please check config.md.
	""")

	:error
	else
	:ok
	end
	end

	def warn do
	[
	check_hellthread_threshold(),
	check_old_mrf_config(),
	check_media_proxy_whitelist_config(),
	check_welcome_message_config(),
	check_activity_expiration_config(),
	check_remote_ip_plug_name(),
	check_uploders_s3_public_endpoint(),
	check_quarantined_instances_tuples(),
	check_transparency_exclusions_tuples(),
	check_simple_policy_tuples(),
	check_http_adapter(),
	check_uploader_base_url_set(),
	- check_uploader_base_url_is_not_base_domain()
	+ check_uploader_base_url_is_not_base_domain(),
	+ check_exiftool_filter()
	]
	\|> Enum.reduce(:ok, fn
	:ok, :ok -> :ok
	_, _ -> :error
	end)
	end

	def check_welcome_message_config do
	instance_config = Pleroma.Config.get([:instance])

	use_old_config =
	Keyword.has_key?(instance_config, :welcome_user_nickname) or
	Keyword.has_key?(instance_config, :welcome_message)

	if use_old_config do
	Logger.error("""
	!!!DEPRECATION WARNING!!!
	Your config is using the old namespace for Welcome messages configuration. You need to convert to the new namespace. e.g.,
	\n* `config :pleroma, :instance, welcome_user_nickname` and `config :pleroma, :instance, welcome_message` are now equal to:
	\n* `config :pleroma, :welcome, direct_message: [enabled: true, sender_nickname: "NICKNAME", message: "Your welcome message"]`"
	""")

	:error
	else
	:ok
	end
	end

	def check_http_adapter do
	http_adapter = Application.get_env(:tesla, :adapter)

	case http_adapter do
	{Tesla.Adapter.Finch, _} ->
	:ok

	Tesla.Mock ->
	# tests do be testing
	:ok

	_anything_else ->
	Logger.error("""
	!!!CONFIG ERROR!!!
	Your config is using a custom tesla adapter, this was standardised
	to finch in 2022.06, and alternate adapters were removed in 2023.02.
	Please ensure you either:
	\n* do not have any custom value for `:tesla, :adapter`, or
	\n* have `config :tesla, :adapter, {Tesla.Adapter.Finch, name: MyFinch}`
	(your current value is #{inspect(http_adapter)})
	""")

	:error
	end
	end

	def check_old_mrf_config do
	warning_preface = """
	!!!DEPRECATION WARNING!!!
	Your config is using old namespaces for MRF configuration. They should work for now, but you are advised to change to new namespaces to prevent possible issues later:
	"""

	move_namespace_and_warn(@mrf_config_map, warning_preface)
	end

	@spec move_namespace_and_warn([config_map()], String.t()) :: :ok \| nil
	def move_namespace_and_warn(config_map, warning_preface) do
	warning =
	Enum.reduce(config_map, "", fn
	{old, new, err_msg}, acc ->
	old_config = Config.get(old)

	if old_config do
	Config.put(new, old_config)
	acc <> err_msg
	else
	acc
	end
	end)

	if warning == "" do
	:ok
	else
	Logger.warning(warning_preface <> warning)
	:error
	end
	end

	@spec check_media_proxy_whitelist_config() :: :ok \| nil
	def check_media_proxy_whitelist_config do
	whitelist = Config.get([:media_proxy, :whitelist])

	if Enum.any?(whitelist, &(not String.starts_with?(&1, "http"))) do
	Logger.warning("""
	!!!DEPRECATION WARNING!!!
	Your config is using old format (only domain) for MediaProxy whitelist option. Setting should work for now, but you are advised to change format to scheme with port to prevent possible issues later.
	""")

	:error
	else
	:ok
	end
	end

	@spec check_activity_expiration_config() :: :ok \| nil
	def check_activity_expiration_config do
	warning_preface = """
	!!!DEPRECATION WARNING!!!
	Your config is using old namespace for activity expiration configuration. Setting should work for now, but you are advised to change to new namespace to prevent possible issues later:
	"""

	move_namespace_and_warn(
	[
	{Pleroma.ActivityExpiration, Pleroma.Workers.PurgeExpiredActivity,
	"\n* `config :pleroma, Pleroma.ActivityExpiration` is now `config :pleroma, Pleroma.Workers.PurgeExpiredActivity`"}
	],
	warning_preface
	)
	end

	@spec check_remote_ip_plug_name() :: :ok \| nil
	def check_remote_ip_plug_name do
	warning_preface = """
	!!!DEPRECATION WARNING!!!
	Your config is using old namespace for RemoteIp Plug. Setting should work for now, but you are advised to change to new namespace to prevent possible issues later:
	"""

	move_namespace_and_warn(
	[
	{Pleroma.Plugs.RemoteIp, Pleroma.Web.Plugs.RemoteIp,
	"\n* `config :pleroma, Pleroma.Plugs.RemoteIp` is now `config :pleroma, Pleroma.Web.Plugs.RemoteIp`"}
	],
	warning_preface
	)
	end

	@spec check_uploders_s3_public_endpoint() :: :ok \| nil
	def check_uploders_s3_public_endpoint do
	s3_config = Pleroma.Config.get([Pleroma.Uploaders.S3])

	use_old_config = Keyword.has_key?(s3_config, :public_endpoint)

	if use_old_config do
	Logger.error("""
	!!!DEPRECATION WARNING!!!
	Your config is using the old setting for controlling the URL of media uploaded to your S3 bucket.\n
	Please make the following change at your earliest convenience.\n
	\n* `config :pleroma, Pleroma.Uploaders.S3, public_endpoint` is now equal to:
	\n* `config :pleroma, Pleroma.Upload, base_url`
	""")

	:error
	else
	:ok
	end
	end

	def check_uploader_base_url_set() do
	uses_local_uploader? = Config.get([Pleroma.Upload, :uploader]) == Pleroma.Uploaders.Local
	base_url = Pleroma.Config.get([Pleroma.Upload, :base_url])

	if base_url \|\| !uses_local_uploader? do
	:ok
	else
	Logger.error("""
	!!!WARNING!!!
	Your config does not specify a base_url for uploads!
	Please make the following change:\n
	\n* `config :pleroma, Pleroma.Upload, base_url: "https://example.com/media/`
	\n
	\nPlease note that it is HEAVILY recommended to use a subdomain to host user-uploaded media!
	""")

	# This is a hard exit - the uploader will not work without a base_url
	raise ArgumentError, message: "No base_url set for uploads - please set one in your config!"
	end
	end

	def check_uploader_base_url_is_not_base_domain() do
	uses_local_uploader? = Config.get([Pleroma.Upload, :uploader]) == Pleroma.Uploaders.Local

	uploader_host =
	[Pleroma.Upload, :base_url]
	\|> Pleroma.Config.get()
	\|> URI.parse()
	\|> Map.get(:host)

	akkoma_host =
	[Pleroma.Web.Endpoint, :url]
	\|> Pleroma.Config.get()
	\|> Keyword.get(:host)

	if uploader_host == akkoma_host && uses_local_uploader? do
	Logger.error("""
	!!!WARNING!!!
	Your Akkoma Host and your Upload base_url's host are the same!
	This can potentially be insecure!

	It is HIGHLY recommended that you migrate your media uploads
	to a subdomain at your earliest convenience
	""")
	end

	# This isn't actually an error condition, just a warning
	:ok
	end
	end
	diff --git a/lib/pleroma/upload.ex b/lib/pleroma/upload.ex
	index b6a32d87a..ad5c2c655 100644
	--- a/lib/pleroma/upload.ex
	+++ b/lib/pleroma/upload.ex
	@@ -1,267 +1,280 @@
	# Pleroma: A lightweight social networking server
	# Copyright © 2017-2021 Pleroma Authors <https://pleroma.social/>
	# SPDX-License-Identifier: AGPL-3.0-only

	defmodule Pleroma.Upload do
	@moduledoc """
	Manage user uploads

	Options:
	* `:type`: presets for activity type (defaults to Document) and size limits from app configuration
	* `:description`: upload alternative text
	* `:base_url`: override base url
	* `:uploader`: override uploader
	* `:filters`: override filters
	* `:size_limit`: override size limit
	* `:activity_type`: override activity type

	The `%Pleroma.Upload{}` struct: all documented fields are meant to be overwritten in filters:

	* `:id` - the upload id.
	* `:name` - the upload file name.
	* `:path` - the upload path: set at first to `id/name` but can be changed. Keep in mind that the path
	is once created permanent and changing it (especially in uploaders) is probably a bad idea!
	* `:tempfile` - path to the temporary file. Prefer in-place changes on the file rather than changing the
	path as the temporary file is also tracked by `Plug.Upload{}` and automatically deleted once the request is over.
	* `:width` - width of the media in pixels
	* `:height` - height of the media in pixels
	* `:blurhash` - string hash of the image encoded with the blurhash algorithm (https://blurha.sh/)

	Related behaviors:

	* `Pleroma.Uploaders.Uploader`
	* `Pleroma.Upload.Filter`

	"""
	alias Ecto.UUID
	alias Pleroma.Config
	alias Pleroma.Maps
	alias Pleroma.Web.ActivityPub.Utils
	require Logger

	@type source ::
	Plug.Upload.t()
	\| (data_uri_string :: String.t())
	\| {:from_local, name :: String.t(), id :: String.t(), path :: String.t()}
	\| map()

	@type option ::
	{:type, :avatar \| :banner \| :background}
	\| {:description, String.t()}
	\| {:activity_type, String.t()}
	\| {:size_limit, nil \| non_neg_integer()}
	\| {:uploader, module()}
	\| {:filters, [module()]}

	@type t :: %__MODULE__{
	id: String.t(),
	name: String.t(),
	tempfile: String.t(),
	content_type: String.t(),
	width: integer(),
	height: integer(),
	blurhash: String.t(),
	+ description: String.t(),
	path: String.t()
	}

	@always_enabled_filters [Pleroma.Upload.Filter.Dedupe]

	- defstruct [:id, :name, :tempfile, :content_type, :width, :height, :blurhash, :path]
	+ defstruct [
	+ :id,
	+ :name,
	+ :tempfile,
	+ :content_type,
	+ :width,
	+ :height,
	+ :blurhash,
	+ :description,
	+ :path
	+ ]

	@spec store(source, options :: [option()]) :: {:ok, Map.t()} \| {:error, any()}
	@doc "Store a file. If using a `Plug.Upload{}` as the source, be sure to use `Majic.Plug` to ensure its content_type and filename is correct."
	def store(upload, opts \\ []) do
	opts = get_opts(opts)

	with {:ok, upload} <- prepare_upload(upload, opts),
	upload = %__MODULE__{upload \| path: upload.path \|\| "#{upload.id}/#{upload.name}"},
	{:ok, upload} <- Pleroma.Upload.Filter.filter(opts.filters, upload),
	- description = Map.get(opts, :description) \|\| "",
	+ description = Map.get(upload, :description) \|\| "",
	{_, true} <-
	{:description_limit,
	String.length(description) <= Pleroma.Config.get([:instance, :description_limit])},
	{:ok, url_spec} <- Pleroma.Uploaders.Uploader.put_file(opts.uploader, upload) do
	{:ok,
	%{
	"id" => Utils.generate_object_id(),
	"type" => opts.activity_type,
	"mediaType" => upload.content_type,
	"url" => [
	%{
	"type" => "Link",
	"mediaType" => upload.content_type,
	"href" => url_from_spec(upload, opts.base_url, url_spec)
	}
	\|> Maps.put_if_present("width", upload.width)
	\|> Maps.put_if_present("height", upload.height)
	],
	"name" => description
	}
	\|> Maps.put_if_present("blurhash", upload.blurhash)}
	else
	{:description_limit, _} ->
	{:error, :description_too_long}

	{:error, error} ->
	Logger.error(
	"#{__MODULE__} store (using #{inspect(opts.uploader)}) failed: #{inspect(error)}"
	)

	{:error, error}
	end
	end

	def char_unescaped?(char) do
	URI.char_unreserved?(char) or char == ?/
	end

	defp get_opts(opts) do
	{size_limit, activity_type} =
	case Keyword.get(opts, :type) do
	:banner ->
	{Pleroma.Config.get!([:instance, :banner_upload_limit]), "Image"}

	:avatar ->
	{Pleroma.Config.get!([:instance, :avatar_upload_limit]), "Image"}

	:background ->
	{Pleroma.Config.get!([:instance, :background_upload_limit]), "Image"}

	_ ->
	{Pleroma.Config.get!([:instance, :upload_limit]), "Document"}
	end

	%{
	activity_type: Keyword.get(opts, :activity_type, activity_type),
	size_limit: Keyword.get(opts, :size_limit, size_limit),
	uploader: Keyword.get(opts, :uploader, Pleroma.Config.get([__MODULE__, :uploader])),
	filters:
	Enum.uniq(
	Keyword.get(opts, :filters, Pleroma.Config.get([__MODULE__, :filters])) ++
	@always_enabled_filters
	),
	description: Keyword.get(opts, :description),
	base_url: base_url()
	}
	end

	defp prepare_upload(%Plug.Upload{} = file, opts) do
	with :ok <- check_file_size(file.path, opts.size_limit) do
	{:ok,
	%__MODULE__{
	id: UUID.generate(),
	name: file.filename,
	tempfile: file.path,
	- content_type: file.content_type
	+ content_type: file.content_type,
	+ description: opts.description
	}}
	end
	end

	defp prepare_upload(%{img: "data:image/" <> image_data}, opts) do
	parsed = Regex.named_captures(~r/(?<filetype>jpeg\|png\|gif);base64,(?<data>.*)/, image_data)
	data = Base.decode64!(parsed["data"], ignore: :whitespace)
	hash = Base.encode16(:crypto.hash(:sha256, data), case: :lower)

	with :ok <- check_binary_size(data, opts.size_limit),
	tmp_path <- tempfile_for_image(data),
	{:ok, %{mime_type: content_type}} <-
	Majic.perform({:bytes, data}, pool: Pleroma.MajicPool),
	[ext \| _] <- MIME.extensions(content_type) do
	{:ok,
	%__MODULE__{
	id: UUID.generate(),
	name: hash <> "." <> ext,
	tempfile: tmp_path,
	- content_type: content_type
	+ content_type: content_type,
	+ description: opts.description
	}}
	end
	end

	# For Mix.Tasks.MigrateLocalUploads
	defp prepare_upload(%__MODULE__{tempfile: path} = upload, _opts) do
	with {:ok, %{mime_type: content_type}} <- Majic.perform(path, pool: Pleroma.MajicPool) do
	{:ok, %__MODULE__{upload \| content_type: content_type}}
	end
	end

	defp check_binary_size(binary, size_limit)
	when is_integer(size_limit) and size_limit > 0 and byte_size(binary) >= size_limit do
	{:error, :file_too_large}
	end

	defp check_binary_size(_, _), do: :ok

	defp check_file_size(path, size_limit) when is_integer(size_limit) and size_limit > 0 do
	with {:ok, %{size: size}} <- File.stat(path),
	true <- size <= size_limit do
	:ok
	else
	false -> {:error, :file_too_large}
	error -> error
	end
	end

	defp check_file_size(_, _), do: :ok

	# Creates a tempfile using the Plug.Upload Genserver which cleans them up
	# automatically.
	defp tempfile_for_image(data) do
	{:ok, tmp_path} = Plug.Upload.random_file("profile_pics")
	{:ok, tmp_file} = File.open(tmp_path, [:write, :raw, :binary])
	IO.binwrite(tmp_file, data)

	tmp_path
	end

	defp url_from_spec(%__MODULE__{name: name}, base_url, {:file, path}) do
	path =
	URI.encode(path, &char_unescaped?/1) <>
	if Pleroma.Config.get([__MODULE__, :link_name], false) do
	"?name=#{URI.encode(name, &char_unescaped?/1)}"
	else
	""
	end

	[base_url, path]
	\|> Path.join()
	end

	defp url_from_spec(_upload, _base_url, {:url, url}), do: url

	def base_url do
	uploader = Config.get([Pleroma.Upload, :uploader])
	upload_base_url = Config.get([Pleroma.Upload, :base_url])
	public_endpoint = Config.get([uploader, :public_endpoint])

	case uploader do
	Pleroma.Uploaders.Local ->
	upload_base_url

	Pleroma.Uploaders.S3 ->
	bucket = Config.get([Pleroma.Uploaders.S3, :bucket])
	truncated_namespace = Config.get([Pleroma.Uploaders.S3, :truncated_namespace])
	namespace = Config.get([Pleroma.Uploaders.S3, :bucket_namespace])

	bucket_with_namespace =
	cond do
	!is_nil(truncated_namespace) ->
	truncated_namespace

	!is_nil(namespace) ->
	namespace <> ":" <> bucket

	true ->
	bucket
	end

	if public_endpoint do
	Path.join([public_endpoint, bucket_with_namespace])
	else
	Path.join([upload_base_url, bucket_with_namespace])
	end

	_ ->
	public_endpoint \|\| upload_base_url
	end
	end
	end
	diff --git a/lib/pleroma/upload/filter/exiftool/read_description.ex b/lib/pleroma/upload/filter/exiftool/read_description.ex
	new file mode 100644
	index 000000000..5dfe60cd8
	--- /dev/null
	+++ b/lib/pleroma/upload/filter/exiftool/read_description.ex
	@@ -0,0 +1,52 @@
	+# Pleroma: A lightweight social networking server
	+# Copyright © 2017-2021 Pleroma Authors <https://pleroma.social/>
	+# SPDX-License-Identifier: AGPL-3.0-only
	+
	+defmodule Pleroma.Upload.Filter.Exiftool.ReadDescription do
	+ @moduledoc """
	+ Gets a valid description from the related EXIF tags and provides them in the response if no description is provided yet.
	+ It will first check ImageDescription, when that doesn't probide a valid description, it will check iptc:Caption-Abstract.
	+ A valid description means the fields are filled in and not too long (see `:instance, :description_limit`).
	+ """
	+ @behaviour Pleroma.Upload.Filter
	+
	+ @spec filter(Pleroma.Upload.t()) :: {:ok, any()} \| {:error, String.t()}
	+
	+ def filter(%Pleroma.Upload{description: description})
	+ when is_binary(description),
	+ do: {:ok, :noop}
	+
	+ def filter(%Pleroma.Upload{tempfile: file} = upload),
	+ do: {:ok, :filtered, upload \|> Map.put(:description, read_description_from_exif_data(file))}
	+
	+ def filter(_, _), do: {:ok, :noop}
	+
	+ defp read_description_from_exif_data(file) do
	+ nil
	+ \|> read_when_empty(file, "-ImageDescription")
	+ \|> read_when_empty(file, "-iptc:Caption-Abstract")
	+ end
	+
	+ defp read_when_empty(current_description, _, _) when is_binary(current_description),
	+ do: current_description
	+
	+ defp read_when_empty(_, file, tag) do
	+ try do
	+ {tag_content, 0} =
	+ System.cmd("exiftool", ["-b", "-s3", tag, file],
	+ stderr_to_stdout: true,
	+ parallelism: true
	+ )
	+
	+ tag_content = String.trim(tag_content)
	+
	+ if tag_content != "" and
	+ String.length(tag_content) <=
	+ Pleroma.Config.get([:instance, :description_limit]),
	+ do: tag_content,
	+ else: nil
	+ rescue
	+ _ in ErlangError -> nil
	+ end
	+ end
	+end
	diff --git a/lib/pleroma/upload/filter/exiftool.ex b/lib/pleroma/upload/filter/exiftool/strip_metadata.ex
	similarity index 95%
	rename from lib/pleroma/upload/filter/exiftool.ex
	rename to lib/pleroma/upload/filter/exiftool/strip_metadata.ex
	index 4d3a5f551..178b595f3 100644
	--- a/lib/pleroma/upload/filter/exiftool.ex
	+++ b/lib/pleroma/upload/filter/exiftool/strip_metadata.ex
	@@ -1,33 +1,33 @@
	# Pleroma: A lightweight social networking server
	# Copyright © 2017-2021 Pleroma Authors <https://pleroma.social/>
	# SPDX-License-Identifier: AGPL-3.0-only

	-defmodule Pleroma.Upload.Filter.Exiftool do
	+defmodule Pleroma.Upload.Filter.Exiftool.StripMetadata do
	@moduledoc """
	Strips GPS related EXIF tags and overwrites the file in place.
	Also strips or replaces filesystem metadata e.g., timestamps.
	"""
	@behaviour Pleroma.Upload.Filter

	@spec filter(Pleroma.Upload.t()) :: {:ok, :noop} \| {:ok, :filtered} \| {:error, String.t()}

	# Formats not compatible with exiftool at this time
	def filter(%Pleroma.Upload{content_type: "image/heic"}), do: {:ok, :noop}
	def filter(%Pleroma.Upload{content_type: "image/webp"}), do: {:ok, :noop}
	def filter(%Pleroma.Upload{content_type: "image/svg+xml"}), do: {:ok, :noop}
	def filter(%Pleroma.Upload{content_type: "image/jxl"}), do: {:ok, :noop}

	def filter(%Pleroma.Upload{tempfile: file, content_type: "image" <> _}) do
	try do
	case System.cmd("exiftool", ["-overwrite_original", "-gps:all=", file], parallelism: true) do
	{_response, 0} -> {:ok, :filtered}
	{error, 1} -> {:error, error}
	end
	rescue
	e in ErlangError ->
	{:error, "#{__MODULE__}: #{inspect(e)}"}
	end
	end

	def filter(_), do: {:ok, :noop}
	end
	diff --git a/lib/pleroma/web/telemetry.ex b/lib/pleroma/web/telemetry.ex
	index 269f9f238..0ddb2c903 100644
	--- a/lib/pleroma/web/telemetry.ex
	+++ b/lib/pleroma/web/telemetry.ex
	@@ -1,239 +1,238 @@
	defmodule Pleroma.Web.Telemetry do
	use Supervisor
	import Telemetry.Metrics
	alias Pleroma.Stats
	alias Pleroma.Config

	def start_link(arg) do
	Supervisor.start_link(__MODULE__, arg, name: __MODULE__)
	end

	@impl true
	def init(_arg) do
	children =
	[
	{:telemetry_poller, measurements: periodic_measurements(), period: 10_000}
	] ++
	prometheus_children()

	Supervisor.init(children, strategy: :one_for_one)
	end

	defp prometheus_children do
	config = Config.get([:instance, :export_prometheus_metrics], true)

	if config do
	[
	{TelemetryMetricsPrometheus.Core, metrics: prometheus_metrics()},
	Pleroma.PrometheusExporter
	]
	else
	[]
	end
	end

	# A seperate set of metrics for distributions because phoenix dashboard does NOT handle them well
	defp distribution_metrics do
	[
	distribution(
	"phoenix.router_dispatch.stop.duration",
	# event_name: [:pleroma, :repo, :query, :total_time],
	measurement: :duration,
	unit: {:native, :second},
	tags: [:route],
	reporter_options: [
	buckets: [0.1, 0.2, 0.5, 1, 2.5, 5, 10, 25, 50, 100, 250, 500, 1000]
	]
	),

	# Database Time Metrics
	distribution(
	"pleroma.repo.query.total_time",
	# event_name: [:pleroma, :repo, :query, :total_time],
	measurement: :total_time,
	unit: {:native, :millisecond},
	reporter_options: [
	buckets: [0.1, 0.2, 0.5, 1, 2.5, 5, 10, 25, 50, 100, 250, 500, 1000]
	]
	),
	distribution(
	"pleroma.repo.query.queue_time",
	# event_name: [:pleroma, :repo, :query, :total_time],
	measurement: :queue_time,
	unit: {:native, :millisecond},
	reporter_options: [
	buckets: [0.01, 0.025, 0.05, 0.1, 0.2, 0.5, 1, 2.5, 5, 10]
	]
	),
	distribution(
	"oban_job_exception",
	event_name: [:oban, :job, :exception],
	measurement: :duration,
	tags: [:worker],
	tag_values: fn tags -> Map.put(tags, :worker, tags.job.worker) end,
	unit: {:native, :second},
	reporter_options: [
	buckets: [0.01, 0.025, 0.05, 0.1, 0.2, 0.5, 1, 2.5, 5, 10]
	]
	),
	distribution(
	"tesla_request_completed",
	event_name: [:tesla, :request, :stop],
	measurement: :duration,
	tags: [:response_code],
	tag_values: fn tags -> Map.put(tags, :response_code, tags.env.status) end,
	unit: {:native, :second},
	reporter_options: [
	buckets: [0.01, 0.025, 0.05, 0.1, 0.2, 0.5, 1, 2.5, 5, 10]
	]
	),
	distribution(
	"oban_job_completion",
	event_name: [:oban, :job, :stop],
	measurement: :duration,
	tags: [:worker],
	tag_values: fn tags -> Map.put(tags, :worker, tags.job.worker) end,
	unit: {:native, :second},
	reporter_options: [
	buckets: [0.01, 0.025, 0.05, 0.1, 0.2, 0.5, 1, 2.5, 5, 10]
	]
	)
	]
	end

	# Summary metrics are currently not (yet) supported by the prometheus exporter
	defp summary_metrics(byte_unit) do
	[
	# Phoenix Metrics
	summary("phoenix.endpoint.stop.duration",
	unit: {:native, :millisecond}
	),
	summary("phoenix.router_dispatch.stop.duration",
	tags: [:route],
	unit: {:native, :millisecond}
	),
	summary("pleroma.repo.query.total_time", unit: {:native, :millisecond}),
	summary("pleroma.repo.query.decode_time", unit: {:native, :millisecond}),
	summary("pleroma.repo.query.query_time", unit: {:native, :millisecond}),
	summary("pleroma.repo.query.queue_time", unit: {:native, :millisecond}),
	summary("pleroma.repo.query.idle_time", unit: {:native, :millisecond}),

	# VM Metrics
	summary("vm.memory.total", unit: {:byte, byte_unit}),
	summary("vm.total_run_queue_lengths.total"),
	summary("vm.total_run_queue_lengths.cpu"),
	summary("vm.total_run_queue_lengths.io")
	]
	end

	defp sum_counter_pair(basename, opts) do
	[
	sum(basename <> ".psum", opts),
	counter(basename <> ".pcount", opts)
	]
	end

	# Prometheus exporter doesn't support summaries, so provide fallbacks
	defp summary_fallback_metrics(byte_unit \\ :byte) do
	# Summary metrics are not supported by the Prometheus exporter
	# https://github.com/beam-telemetry/telemetry_metrics_prometheus_core/issues/11
	# and sum metrics currently only work with integers
	# https://github.com/beam-telemetry/telemetry_metrics_prometheus_core/issues/35
	#
	# For VM metrics this is kindof ok as they appear to always be integers
	# and we can use sum + counter to get the average between polls from their change
	# But for repo query times we need to use a full distribution

	simple_buckets = [0, 1, 2, 4, 8, 16]
	simple_buckets_quick = for t <- simple_buckets, do: t / 100.0

	# Already included in distribution metrics anyway:
	# phoenix.router_dispatch.stop.duration
	# pleroma.repo.query.total_time
	# pleroma.repo.query.queue_time
	- dist_metrics =
	- [
	- distribution("phoenix.endpoint.stop.duration.fdist",
	- event_name: [:phoenix, :endpoint, :stop],
	- measurement: :duration,
	- unit: {:native, :millisecond},
	- reporter_options: [
	- buckets: simple_buckets
	- ]
	- ),
	- distribution("pleroma.repo.query.decode_time.fdist",
	- event_name: [:pleroma, :repo, :query],
	- measurement: :decode_time,
	- unit: {:native, :millisecond},
	- reporter_options: [
	- buckets: simple_buckets_quick
	- ]
	- ),
	- distribution("pleroma.repo.query.query_time.fdist",
	- event_name: [:pleroma, :repo, :query],
	- measurement: :query_time,
	- unit: {:native, :millisecond},
	- reporter_options: [
	- buckets: simple_buckets
	- ]
	- ),
	- distribution("pleroma.repo.query.idle_time.fdist",
	- event_name: [:pleroma, :repo, :query],
	- measurement: :idle_time,
	- unit: {:native, :millisecond},
	- reporter_options: [
	- buckets: simple_buckets
	- ]
	- )
	- ]
	+ dist_metrics = [
	+ distribution("phoenix.endpoint.stop.duration.fdist",
	+ event_name: [:phoenix, :endpoint, :stop],
	+ measurement: :duration,
	+ unit: {:native, :millisecond},
	+ reporter_options: [
	+ buckets: simple_buckets
	+ ]
	+ ),
	+ distribution("pleroma.repo.query.decode_time.fdist",
	+ event_name: [:pleroma, :repo, :query],
	+ measurement: :decode_time,
	+ unit: {:native, :millisecond},
	+ reporter_options: [
	+ buckets: simple_buckets_quick
	+ ]
	+ ),
	+ distribution("pleroma.repo.query.query_time.fdist",
	+ event_name: [:pleroma, :repo, :query],
	+ measurement: :query_time,
	+ unit: {:native, :millisecond},
	+ reporter_options: [
	+ buckets: simple_buckets
	+ ]
	+ ),
	+ distribution("pleroma.repo.query.idle_time.fdist",
	+ event_name: [:pleroma, :repo, :query],
	+ measurement: :idle_time,
	+ unit: {:native, :millisecond},
	+ reporter_options: [
	+ buckets: simple_buckets
	+ ]
	+ )
	+ ]

	vm_metrics =
	sum_counter_pair("vm.memory.total",
	event_name: [:vm, :memory],
	measurement: :total,
	unit: {:byte, byte_unit}
	) ++
	sum_counter_pair("vm.total_run_queue_lengths.total",
	event_name: [:vm, :total_run_queue_lengths],
	measurement: :total
	) ++
	sum_counter_pair("vm.total_run_queue_lengths.cpu",
	event_name: [:vm, :total_run_queue_lengths],
	measurement: :cpu
	) ++
	sum_counter_pair("vm.total_run_queue_lengths.io.fsum",
	event_name: [:vm, :total_run_queue_lengths],
	measurement: :io
	)

	dist_metrics ++ vm_metrics
	end

	defp common_metrics do
	[
	last_value("pleroma.local_users.total"),
	last_value("pleroma.domains.total"),
	last_value("pleroma.local_statuses.total"),
	last_value("pleroma.remote_users.total")
	]
	end

	def prometheus_metrics,
	do: common_metrics() ++ distribution_metrics() ++ summary_fallback_metrics()

	def live_dashboard_metrics, do: common_metrics() ++ summary_metrics(:megabyte)

	defp periodic_measurements do
	[
	{__MODULE__, :instance_stats, []}
	]
	end

	def instance_stats do
	stats = Stats.get_stats()
	:telemetry.execute([:pleroma, :local_users], %{total: stats.user_count}, %{})
	:telemetry.execute([:pleroma, :domains], %{total: stats.domain_count}, %{})
	:telemetry.execute([:pleroma, :local_statuses], %{total: stats.status_count}, %{})
	:telemetry.execute([:pleroma, :remote_users], %{total: stats.remote_user_count}, %{})
	end
	end
	diff --git a/priv/repo/migrations/20220220135625_upload_filter_exiftool_to_exiftool_strip_location.exs b/priv/repo/migrations/20220220135625_upload_filter_exiftool_to_exiftool_strip_location.exs
	new file mode 100644
	index 000000000..0d68a0787
	--- /dev/null
	+++ b/priv/repo/migrations/20220220135625_upload_filter_exiftool_to_exiftool_strip_location.exs
	@@ -0,0 +1,37 @@
	+defmodule Pleroma.Repo.Migrations.UploadFilterExiftoolToExiftoolStripMetadata do
	+ use Ecto.Migration
	+
	+ alias Pleroma.ConfigDB
	+
	+ def up,
	+ do:
	+ ConfigDB.get_by_params(%{group: :pleroma, key: Pleroma.Upload})
	+ \|> update_filtername(
	+ Pleroma.Upload.Filter.Exiftool,
	+ Pleroma.Upload.Filter.Exiftool.StripMetadata
	+ )
	+
	+ def down,
	+ do:
	+ ConfigDB.get_by_params(%{group: :pleroma, key: Pleroma.Upload})
	+ \|> update_filtername(
	+ Pleroma.Upload.Filter.Exiftool.StripMetadata,
	+ Pleroma.Upload.Filter.Exiftool
	+ )
	+
	+ defp update_filtername(%{value: value}, from_filtername, to_filtername) do
	+ new_value =
	+ value
	+ \|> Keyword.update(:filters, [], fn filters ->
	+ filters
	+ \|> Enum.map(fn
	+ ^from_filtername -> to_filtername
	+ filter -> filter
	+ end)
	+ end)
	+
	+ ConfigDB.update_or_create(%{group: :pleroma, key: Pleroma.Upload, value: new_value})
	+ end
	+
	+ defp update_filtername(_, _, _), do: nil
	+end
	diff --git a/test/fixtures/image_with_caption-abstract.jpg b/test/fixtures/image_with_caption-abstract.jpg
	new file mode 100644
	index 000000000..f982ffa81
	Binary files /dev/null and b/test/fixtures/image_with_caption-abstract.jpg differ
	diff --git a/test/fixtures/image_with_imagedescription_and_caption-abstract.jpg b/test/fixtures/image_with_imagedescription_and_caption-abstract.jpg
	new file mode 100644
	index 000000000..c82a269ef
	Binary files /dev/null and b/test/fixtures/image_with_imagedescription_and_caption-abstract.jpg differ
	diff --git a/test/fixtures/image_with_imagedescription_and_caption-abstract_whitespaces.jpg b/test/fixtures/image_with_imagedescription_and_caption-abstract_whitespaces.jpg
	new file mode 100644
	index 000000000..a232fd2a1
	Binary files /dev/null and b/test/fixtures/image_with_imagedescription_and_caption-abstract_whitespaces.jpg differ
	diff --git a/test/fixtures/image_with_no_description.jpg b/test/fixtures/image_with_no_description.jpg
	new file mode 100644
	index 000000000..ec6fc4be8
	Binary files /dev/null and b/test/fixtures/image_with_no_description.jpg differ
	diff --git a/test/mix/tasks/pleroma/instance_test.exs b/test/mix/tasks/pleroma/instance_test.exs
	index 17b2e3267..168343ce5 100644
	--- a/test/mix/tasks/pleroma/instance_test.exs
	+++ b/test/mix/tasks/pleroma/instance_test.exs
	@@ -1,103 +1,108 @@
	# Pleroma: A lightweight social networking server
	# Copyright © 2017-2021 Pleroma Authors <https://pleroma.social/>
	# SPDX-License-Identifier: AGPL-3.0-only

	defmodule Mix.Tasks.Pleroma.InstanceTest do
	# Modifies the Application Environment, has to stay synchronous.
	use Pleroma.DataCase

	setup do
	File.mkdir_p!(tmp_path())

	on_exit(fn ->
	File.rm_rf(tmp_path())
	static_dir = Pleroma.Config.get([:instance, :static_dir], "test/instance_static/")

	if File.exists?(static_dir) do
	File.rm_rf(Path.join(static_dir, "robots.txt"))
	end
	end)

	# Is being modified by the mix task.
	clear_config([:instance, :static_dir])

	:ok
	end

	@uuid Ecto.UUID.generate()
	defp tmp_path do
	"/tmp/generated_files/#{@uuid}/"
	end

	test "running gen" do
	mix_task = fn ->
	Mix.Tasks.Pleroma.Instance.run([
	"gen",
	"--output",
	tmp_path() <> "generated_config.exs",
	"--output-psql",
	tmp_path() <> "setup.psql",
	"--domain",
	"test.pleroma.social",
	"--media-url",
	"https://media.pleroma.social/media",
	"--instance-name",
	"Pleroma",
	"--admin-email",
	"admin@example.com",
	"--notify-email",
	"notify@example.com",
	"--dbhost",
	"dbhost",
	"--dbname",
	"dbname",
	"--dbuser",
	"dbuser",
	"--dbpass",
	"dbpass",
	"--indexable",
	"y",
	"--db-configurable",
	"y",
	"--rum",
	"y",
	"--listen-port",
	"4000",
	"--listen-ip",
	"127.0.0.1",
	"--uploads-dir",
	"test/uploads",
	"--static-dir",
	"./test/../test/instance/static/",
	- "--strip-uploads",
	+ "--strip-uploads-metadata",
	+ "y",
	+ "--read-uploads-description",
	"y",
	"--anonymize-uploads",
	"n"
	])
	end

	ExUnit.CaptureIO.capture_io(fn ->
	mix_task.()
	end)

	generated_config = File.read!(tmp_path() <> "generated_config.exs")
	assert generated_config =~ "host: \"test.pleroma.social\""
	assert generated_config =~ "name: \"Pleroma\""
	assert generated_config =~ "email: \"admin@example.com\""
	assert generated_config =~ "notify_email: \"notify@example.com\""
	assert generated_config =~ "hostname: \"dbhost\""
	assert generated_config =~ "database: \"dbname\""
	assert generated_config =~ "username: \"dbuser\""
	assert generated_config =~ "password: \"dbpass\""
	assert generated_config =~ "configurable_from_database: true"
	assert generated_config =~ "http: [ip: {127, 0, 0, 1}, port: 4000]"
	- assert generated_config =~ "filters: [Pleroma.Upload.Filter.Exiftool]"
	+
	+ assert generated_config =~
	+ "filters: [Pleroma.Upload.Filter.Exiftool.ReadDescription, Pleroma.Upload.Filter.Exiftool.StripMetadata]"
	+
	assert generated_config =~ "base_url: \"https://media.pleroma.social/media\""
	assert File.read!(tmp_path() <> "setup.psql") == generated_setup_psql()
	assert File.exists?(Path.expand("./test/instance/static/robots.txt"))
	end

	defp generated_setup_psql do
	~s(CREATE USER dbuser WITH ENCRYPTED PASSWORD 'dbpass';\nCREATE DATABASE dbname OWNER dbuser;\n\\c dbname;\n--Extensions made by ecto.migrate that need superuser access\nCREATE EXTENSION IF NOT EXISTS citext;\nCREATE EXTENSION IF NOT EXISTS pg_trgm;\nCREATE EXTENSION IF NOT EXISTS \"uuid-ossp\";\nCREATE EXTENSION IF NOT EXISTS rum;\n)
	end
	end
	diff --git a/test/pleroma/config/deprecation_warnings_test.exs b/test/pleroma/config/deprecation_warnings_test.exs
	index 96d6fd739..fd8a558ee 100644
	--- a/test/pleroma/config/deprecation_warnings_test.exs
	+++ b/test/pleroma/config/deprecation_warnings_test.exs
	@@ -1,352 +1,408 @@
	# Pleroma: A lightweight social networking server
	# Copyright © 2017-2021 Pleroma Authors <https://pleroma.social/>
	# SPDX-License-Identifier: AGPL-3.0-only

	defmodule Pleroma.Config.DeprecationWarningsTest do
	use ExUnit.Case, async: false
	use Pleroma.Tests.Helpers

	import ExUnit.CaptureLog

	alias Pleroma.Config
	alias Pleroma.Config.DeprecationWarnings

	+ describe "filter exiftool" do
	+ test "gives warning when still used" do
	+ clear_config(
	+ [Pleroma.Upload, :filters],
	+ [Pleroma.Upload.Filter.Exiftool]
	+ )
	+
	+ assert capture_log(fn -> DeprecationWarnings.check_exiftool_filter() end) =~
	+ """
	+ !!!DEPRECATION WARNING!!!
	+ Your config is using Exiftool as a filter instead of Exiftool.StripMetadata. This should work for now, but you are advised to change to the new configuration to prevent possible issues later:
	+
	+ ```
	+ config :pleroma, Pleroma.Upload,
	+ filters: [Pleroma.Upload.Filter.Exiftool]
	+ ```
	+
	+ Is now
	+
	+
	+ ```
	+ config :pleroma, Pleroma.Upload,
	+ filters: [Pleroma.Upload.Filter.Exiftool.StripMetadata]
	+ ```
	+ """
	+ end
	+
	+ test "changes setting to exiftool strip metadata" do
	+ clear_config(
	+ [Pleroma.Upload, :filters],
	+ [Pleroma.Upload.Filter.Exiftool, Pleroma.Upload.Filter.Exiftool.ReadDescription]
	+ )
	+
	+ expected_config = [
	+ Pleroma.Upload.Filter.Exiftool.StripMetadata,
	+ Pleroma.Upload.Filter.Exiftool.ReadDescription
	+ ]
	+
	+ capture_log(fn -> DeprecationWarnings.warn() end)
	+
	+ assert Config.get([Pleroma.Upload]) \|> Keyword.get(:filters, []) == expected_config
	+ end
	+
	+ test "doesn't give a warning with correct config" do
	+ clear_config(
	+ [Pleroma.Upload, :filters],
	+ [
	+ Pleroma.Upload.Filter.Exiftool.StripMetadata,
	+ Pleroma.Upload.Filter.Exiftool.ReadDescription
	+ ]
	+ )
	+
	+ assert capture_log(fn -> DeprecationWarnings.check_exiftool_filter() end) == ""
	+ end
	+ end
	+
	describe "simple policy tuples" do
	test "gives warning when there are still strings" do
	clear_config([:mrf_simple],
	media_removal: ["some.removal"],
	media_nsfw: ["some.nsfw"],
	federated_timeline_removal: ["some.tl.removal"],
	report_removal: ["some.report.removal"],
	reject: ["some.reject"],
	followers_only: ["some.followers.only"],
	accept: ["some.accept"],
	avatar_removal: ["some.avatar.removal"],
	banner_removal: ["some.banner.removal"],
	reject_deletes: ["some.reject.deletes"]
	)

	assert capture_log(fn -> DeprecationWarnings.check_simple_policy_tuples() end) =~
	"""
	!!!DEPRECATION WARNING!!!
	Your config is using strings in the SimplePolicy configuration instead of tuples. They should work for now, but you are advised to change to the new configuration to prevent possible issues later:

	```
	config :pleroma, :mrf_simple,
	media_removal: ["instance.tld"],
	media_nsfw: ["instance.tld"],
	federated_timeline_removal: ["instance.tld"],
	report_removal: ["instance.tld"],
	reject: ["instance.tld"],
	followers_only: ["instance.tld"],
	accept: ["instance.tld"],
	avatar_removal: ["instance.tld"],
	banner_removal: ["instance.tld"],
	reject_deletes: ["instance.tld"]
	```

	Is now


	```
	config :pleroma, :mrf_simple,
	media_removal: [{"instance.tld", "Reason for media removal"}],
	media_nsfw: [{"instance.tld", "Reason for media nsfw"}],
	federated_timeline_removal: [{"instance.tld", "Reason for federated timeline removal"}],
	report_removal: [{"instance.tld", "Reason for report removal"}],
	reject: [{"instance.tld", "Reason for reject"}],
	followers_only: [{"instance.tld", "Reason for followers only"}],
	accept: [{"instance.tld", "Reason for accept"}],
	avatar_removal: [{"instance.tld", "Reason for avatar removal"}],
	banner_removal: [{"instance.tld", "Reason for banner removal"}],
	reject_deletes: [{"instance.tld", "Reason for reject deletes"}]
	```
	"""
	end

	test "transforms config to tuples" do
	clear_config([:mrf_simple],
	media_removal: ["some.removal", {"some.other.instance", "Some reason"}]
	)

	expected_config = [
	{:media_removal, [{"some.removal", ""}, {"some.other.instance", "Some reason"}]}
	]

	capture_log(fn -> DeprecationWarnings.warn() end)

	assert Config.get([:mrf_simple]) == expected_config
	end

	test "doesn't give a warning with correct config" do
	clear_config([:mrf_simple],
	media_removal: [{"some.removal", ""}, {"some.other.instance", "Some reason"}]
	)

	assert capture_log(fn -> DeprecationWarnings.check_simple_policy_tuples() end) == ""
	end
	end

	describe "quarantined_instances tuples" do
	test "gives warning when there are still strings" do
	clear_config([:instance, :quarantined_instances], [
	{"domain.com", "some reason"},
	"somedomain.tld"
	])

	assert capture_log(fn -> DeprecationWarnings.check_quarantined_instances_tuples() end) =~
	"""
	!!!DEPRECATION WARNING!!!
	Your config is using strings in the quarantined_instances configuration instead of tuples. They should work for now, but you are advised to change to the new configuration to prevent possible issues later:

	```
	config :pleroma, :instance,
	quarantined_instances: ["instance.tld"]
	```

	Is now


	```
	config :pleroma, :instance,
	quarantined_instances: [{"instance.tld", "Reason for quarantine"}]
	```
	"""
	end

	test "transforms config to tuples" do
	clear_config([:instance, :quarantined_instances], [
	{"domain.com", "some reason"},
	"some.tld"
	])

	expected_config = [{"domain.com", "some reason"}, {"some.tld", ""}]

	capture_log(fn -> DeprecationWarnings.warn() end)

	assert Config.get([:instance, :quarantined_instances]) == expected_config
	end

	test "doesn't give a warning with correct config" do
	clear_config([:instance, :quarantined_instances], [
	{"domain.com", "some reason"},
	{"some.tld", ""}
	])

	assert capture_log(fn -> DeprecationWarnings.check_quarantined_instances_tuples() end) == ""
	end
	end

	describe "transparency_exclusions tuples" do
	test "gives warning when there are still strings" do
	clear_config([:mrf, :transparency_exclusions], [
	{"domain.com", "some reason"},
	"somedomain.tld"
	])

	assert capture_log(fn -> DeprecationWarnings.check_transparency_exclusions_tuples() end) =~
	"""
	!!!DEPRECATION WARNING!!!
	Your config is using strings in the transparency_exclusions configuration instead of tuples. They should work for now, but you are advised to change to the new configuration to prevent possible issues later:

	```
	config :pleroma, :mrf,
	transparency_exclusions: ["instance.tld"]
	```

	Is now


	```
	config :pleroma, :mrf,
	transparency_exclusions: [{"instance.tld", "Reason to exlude transparency"}]
	```
	"""
	end

	test "transforms config to tuples" do
	clear_config([:mrf, :transparency_exclusions], [
	{"domain.com", "some reason"},
	"some.tld"
	])

	expected_config = [{"domain.com", "some reason"}, {"some.tld", ""}]

	capture_log(fn -> DeprecationWarnings.warn() end)

	assert Config.get([:mrf, :transparency_exclusions]) == expected_config
	end

	test "doesn't give a warning with correct config" do
	clear_config([:mrf, :transparency_exclusions], [
	{"domain.com", "some reason"},
	{"some.tld", ""}
	])

	assert capture_log(fn -> DeprecationWarnings.check_transparency_exclusions_tuples() end) ==
	""
	end
	end

	test "check_old_mrf_config/0" do
	clear_config([:instance, :rewrite_policy], [])
	clear_config([:instance, :mrf_transparency], true)
	clear_config([:instance, :mrf_transparency_exclusions], [])

	assert capture_log(fn -> DeprecationWarnings.check_old_mrf_config() end) =~
	"""
	!!!DEPRECATION WARNING!!!
	Your config is using old namespaces for MRF configuration. They should work for now, but you are advised to change to new namespaces to prevent possible issues later:

	* `config :pleroma, :instance, rewrite_policy` is now `config :pleroma, :mrf, policies`
	* `config :pleroma, :instance, mrf_transparency` is now `config :pleroma, :mrf, transparency`
	* `config :pleroma, :instance, mrf_transparency_exclusions` is now `config :pleroma, :mrf, transparency_exclusions`
	"""
	end

	test "move_namespace_and_warn/2" do
	old_group1 = [:group, :key]
	old_group2 = [:group, :key2]
	old_group3 = [:group, :key3]

	new_group1 = [:another_group, :key4]
	new_group2 = [:another_group, :key5]
	new_group3 = [:another_group, :key6]

	clear_config(old_group1, 1)
	clear_config(old_group2, 2)
	clear_config(old_group3, 3)

	clear_config(new_group1)
	clear_config(new_group2)
	clear_config(new_group3)

	config_map = [
	{old_group1, new_group1, "\n error :key"},
	{old_group2, new_group2, "\n error :key2"},
	{old_group3, new_group3, "\n error :key3"}
	]

	assert capture_log(fn ->
	DeprecationWarnings.move_namespace_and_warn(
	config_map,
	"Warning preface"
	)
	end) =~ "Warning preface\n error :key\n error :key2\n error :key3"

	assert Config.get(new_group1) == 1
	assert Config.get(new_group2) == 2
	assert Config.get(new_group3) == 3
	end

	test "check_media_proxy_whitelist_config/0" do
	clear_config([:media_proxy, :whitelist], ["https://example.com", "example2.com"])

	assert capture_log(fn ->
	DeprecationWarnings.check_media_proxy_whitelist_config()
	end) =~ "Your config is using old format (only domain) for MediaProxy whitelist option"
	end

	test "check_welcome_message_config/0" do
	clear_config([:instance, :welcome_user_nickname], "LainChan")

	assert capture_log(fn ->
	DeprecationWarnings.check_welcome_message_config()
	end) =~ "Your config is using the old namespace for Welcome messages configuration."
	end

	test "check_hellthread_threshold/0" do
	clear_config([:mrf_hellthread, :threshold], 16)

	assert capture_log(fn ->
	DeprecationWarnings.check_hellthread_threshold()
	end) =~ "You are using the old configuration mechanism for the hellthread filter."
	end

	test "check_activity_expiration_config/0" do
	clear_config([Pleroma.ActivityExpiration], enabled: true)

	assert capture_log(fn ->
	DeprecationWarnings.check_activity_expiration_config()
	end) =~ "Your config is using old namespace for activity expiration configuration."
	end

	test "check_uploders_s3_public_endpoint/0" do
	clear_config([Pleroma.Uploaders.S3], public_endpoint: "https://fake.amazonaws.com/bucket/")

	assert capture_log(fn ->
	DeprecationWarnings.check_uploders_s3_public_endpoint()
	end) =~
	"Your config is using the old setting for controlling the URL of media uploaded to your S3 bucket."
	end

	test "check_http_adapter/0" do
	Application.put_env(:tesla, :adapter, Gun)

	assert capture_log(fn ->
	DeprecationWarnings.check_http_adapter()
	end) =~ "Your config is using a custom tesla adapter"

	Application.put_env(:tesla, :adapter, Tesla.Mock)
	end

	describe "check_uploader_base_url_set/0" do
	test "should error if the base_url is not set" do
	clear_config([Pleroma.Upload, :base_url], nil)

	# we need to capture the error
	assert_raise ArgumentError, fn ->
	assert capture_log(fn ->
	DeprecationWarnings.check_uploader_base_url_set()
	end) =~ "Your config does not specify a base_url for uploads!"
	end
	end

	test "should not error if the base_url is set" do
	clear_config([Pleroma.Upload, :base_url], "https://example.com")

	refute capture_log(fn ->
	DeprecationWarnings.check_uploader_base_url_set()
	end) =~ "Your config does not specify a base_url for uploads!"
	end

	test "should not error if local uploader is not used" do
	clear_config([Pleroma.Upload, :base_url], nil)
	clear_config([Pleroma.Upload, :uploader], Pleroma.Uploaders.S3)

	refute capture_log(fn ->
	DeprecationWarnings.check_uploader_base_url_set()
	end) =~ "Your config does not specify a base_url for uploads!"
	end
	end

	describe "check_uploader_base_url_is_not_base_domain/0" do
	test "should error if the akkoma domain is the same as the upload domain" do
	clear_config([Pleroma.Upload, :base_url], "http://localhost")

	assert capture_log(fn ->
	DeprecationWarnings.check_uploader_base_url_is_not_base_domain()
	end) =~ "Your Akkoma Host and your Upload base_url's host are the same!"
	end

	test "should not error if the local uploader is not used" do
	clear_config([Pleroma.Upload, :base_url], "http://localhost")
	clear_config([Pleroma.Upload, :uploader], Pleroma.Uploaders.S3)

	refute capture_log(fn ->
	DeprecationWarnings.check_uploader_base_url_is_not_base_domain()
	end) =~ "Your Akkoma Host and your Upload base_url's host are the same!"
	end

	test "should not error if the akkoma domain is different from the upload domain" do
	clear_config([Pleroma.Upload, :base_url], "https://media.localhost")
	clear_config([Pleroma.Upload, :uploader], Pleroma.Uploaders.Local)

	refute capture_log(fn ->
	DeprecationWarnings.check_uploader_base_url_is_not_base_domain()
	end) =~ "Your Akkoma Host and your Upload base_url's host are the same!"

	clear_config([Pleroma.Upload, :base_url])
	end
	end
	end
	diff --git a/test/pleroma/upload/filter/exiftool/read_description_test.exs b/test/pleroma/upload/filter/exiftool/read_description_test.exs
	new file mode 100644
	index 000000000..7389fda47
	--- /dev/null
	+++ b/test/pleroma/upload/filter/exiftool/read_description_test.exs
	@@ -0,0 +1,117 @@
	+# Pleroma: A lightweight social networking server
	+# Copyright © 2017-2021 Pleroma Authors <https://pleroma.social/>
	+# SPDX-License-Identifier: AGPL-3.0-only
	+
	+defmodule Pleroma.Upload.Filter.Exiftool.ReadDescriptionTest do
	+ use Pleroma.DataCase, async: true
	+ alias Pleroma.Upload.Filter
	+
	+ @uploads %Pleroma.Upload{
	+ name: "image_with_imagedescription_and_caption-abstract.jpg",
	+ content_type: "image/jpeg",
	+ path: Path.absname("test/fixtures/image_with_imagedescription_and_caption-abstract.jpg"),
	+ tempfile: Path.absname("test/fixtures/image_with_imagedescription_and_caption-abstract.jpg"),
	+ description: nil
	+ }
	+
	+ test "keeps description when not empty" do
	+ uploads = %Pleroma.Upload{
	+ name: "image_with_imagedescription_and_caption-abstract.jpg",
	+ content_type: "image/jpeg",
	+ path: Path.absname("test/fixtures/image_with_imagedescription_and_caption-abstract.jpg"),
	+ tempfile:
	+ Path.absname("test/fixtures/image_with_imagedescription_and_caption-abstract.jpg"),
	+ description: "Some description"
	+ }
	+
	+ assert Filter.Exiftool.ReadDescription.filter(uploads) ==
	+ {:ok, :noop}
	+ end
	+
	+ test "otherwise returns ImageDescription when present" do
	+ uploads_after = %Pleroma.Upload{
	+ name: "image_with_imagedescription_and_caption-abstract.jpg",
	+ content_type: "image/jpeg",
	+ path: Path.absname("test/fixtures/image_with_imagedescription_and_caption-abstract.jpg"),
	+ tempfile:
	+ Path.absname("test/fixtures/image_with_imagedescription_and_caption-abstract.jpg"),
	+ description: "a descriptive white pixel"
	+ }
	+
	+ assert Filter.Exiftool.ReadDescription.filter(@uploads) ==
	+ {:ok, :filtered, uploads_after}
	+ end
	+
	+ test "otherwise returns iptc:Caption-Abstract when present" do
	+ upload = %Pleroma.Upload{
	+ name: "image_with_caption-abstract.jpg",
	+ content_type: "image/jpeg",
	+ path: Path.absname("test/fixtures/image_with_caption-abstract.jpg"),
	+ tempfile: Path.absname("test/fixtures/image_with_caption-abstract.jpg"),
	+ description: nil
	+ }
	+
	+ upload_after = %Pleroma.Upload{
	+ name: "image_with_caption-abstract.jpg",
	+ content_type: "image/jpeg",
	+ path: Path.absname("test/fixtures/image_with_caption-abstract.jpg"),
	+ tempfile: Path.absname("test/fixtures/image_with_caption-abstract.jpg"),
	+ description: "an abstract white pixel"
	+ }
	+
	+ assert Filter.Exiftool.ReadDescription.filter(upload) ==
	+ {:ok, :filtered, upload_after}
	+ end
	+
	+ test "otherwise returns nil" do
	+ uploads = %Pleroma.Upload{
	+ name: "image_with_no_description.jpg",
	+ content_type: "image/jpeg",
	+ path: Path.absname("test/fixtures/image_with_no_description.jpg"),
	+ tempfile: Path.absname("test/fixtures/image_with_no_description.jpg"),
	+ description: nil
	+ }
	+
	+ assert Filter.Exiftool.ReadDescription.filter(uploads) ==
	+ {:ok, :filtered, uploads}
	+ end
	+
	+ test "Return nil when image description from EXIF data exceeds the maximum length" do
	+ clear_config([:instance, :description_limit], 5)
	+
	+ assert Filter.Exiftool.ReadDescription.filter(@uploads) ==
	+ {:ok, :filtered, @uploads}
	+ end
	+
	+ test "Ignores content with only whitespace" do
	+ uploads = %Pleroma.Upload{
	+ name: "non-existant.jpg",
	+ content_type: "image/jpeg",
	+ path:
	+ Path.absname(
	+ "test/fixtures/image_with_imagedescription_and_caption-abstract_whitespaces.jpg"
	+ ),
	+ tempfile:
	+ Path.absname(
	+ "test/fixtures/image_with_imagedescription_and_caption-abstract_whitespaces.jpg"
	+ ),
	+ description: nil
	+ }
	+
	+ assert Filter.Exiftool.ReadDescription.filter(uploads) ==
	+ {:ok, :filtered, uploads}
	+ end
	+
	+ test "Return nil when image description from EXIF data can't be read" do
	+ uploads = %Pleroma.Upload{
	+ name: "non-existant.jpg",
	+ content_type: "image/jpeg",
	+ path: Path.absname("test/fixtures/non-existant.jpg"),
	+ tempfile: Path.absname("test/fixtures/non-existant_tmp.jpg"),
	+ description: nil
	+ }
	+
	+ assert Filter.Exiftool.ReadDescription.filter(uploads) ==
	+ {:ok, :filtered, uploads}
	+ end
	+end
	diff --git a/test/pleroma/upload/filter/exiftool_test.exs b/test/pleroma/upload/filter/exiftool/strip_location_test.exs
	similarity index 83%
	rename from test/pleroma/upload/filter/exiftool_test.exs
	rename to test/pleroma/upload/filter/exiftool/strip_location_test.exs
	index 5f38fa277..6f8178115 100644
	--- a/test/pleroma/upload/filter/exiftool_test.exs
	+++ b/test/pleroma/upload/filter/exiftool/strip_location_test.exs
	@@ -1,42 +1,42 @@
	# Pleroma: A lightweight social networking server
	# Copyright © 2017-2021 Pleroma Authors <https://pleroma.social/>
	# SPDX-License-Identifier: AGPL-3.0-only

	-defmodule Pleroma.Upload.Filter.ExiftoolTest do
	+defmodule Pleroma.Upload.Filter.Exiftool.StripMetadataTest do
	use Pleroma.DataCase
	alias Pleroma.Upload.Filter

	test "apply exiftool filter" do
	assert Pleroma.Utils.command_available?("exiftool")

	File.cp!(
	"test/fixtures/DSCN0010.jpg",
	"test/fixtures/DSCN0010_tmp.jpg"
	)

	upload = %Pleroma.Upload{
	name: "image_with_GPS_data.jpg",
	content_type: "image/jpeg",
	path: Path.absname("test/fixtures/DSCN0010.jpg"),
	tempfile: Path.absname("test/fixtures/DSCN0010_tmp.jpg")
	}

	- assert Filter.Exiftool.filter(upload) == {:ok, :filtered}
	+ assert Filter.Exiftool.StripMetadata.filter(upload) == {:ok, :filtered}

	{exif_original, 0} = System.cmd("exiftool", ["test/fixtures/DSCN0010.jpg"])
	{exif_filtered, 0} = System.cmd("exiftool", ["test/fixtures/DSCN0010_tmp.jpg"])

	refute exif_original == exif_filtered
	assert String.match?(exif_original, ~r/GPS/)
	refute String.match?(exif_filtered, ~r/GPS/)
	end

	test "verify webp files are skipped" do
	upload = %Pleroma.Upload{
	name: "sample.webp",
	content_type: "image/webp"
	}

	- assert Filter.Exiftool.filter(upload) == {:ok, :noop}
	+ assert Filter.Exiftool.StripMetadata.filter(upload) == {:ok, :noop}
	end
	end
	diff --git a/test/pleroma/web/activity_pub/object_validators/attachment_validator_test.exs b/test/pleroma/web/activity_pub/object_validators/attachment_validator_test.exs
	index f8dec09d3..22a8d0899 100644
	--- a/test/pleroma/web/activity_pub/object_validators/attachment_validator_test.exs
	+++ b/test/pleroma/web/activity_pub/object_validators/attachment_validator_test.exs
	@@ -1,158 +1,157 @@
	# Pleroma: A lightweight social networking server
	# Copyright © 2017-2021 Pleroma Authors <https://pleroma.social/>
	# SPDX-License-Identifier: AGPL-3.0-only

	defmodule Pleroma.Web.ActivityPub.ObjectValidators.AttachmentValidatorTest do
	use Pleroma.DataCase, async: true

	alias Pleroma.Web.ActivityPub.ActivityPub
	alias Pleroma.Web.ActivityPub.ObjectValidators.AttachmentValidator

	import Pleroma.Factory

	describe "attachments" do
	test "works with apng" do
	- attachment =
	- %{
	- "mediaType" => "image/apng",
	- "name" => "",
	- "type" => "Document",
	- "url" =>
	- "https://media.misskeyusercontent.com/io/2859c26e-cd43-4550-848b-b6243bc3fe28.apng"
	- }
	+ attachment = %{
	+ "mediaType" => "image/apng",
	+ "name" => "",
	+ "type" => "Document",
	+ "url" =>
	+ "https://media.misskeyusercontent.com/io/2859c26e-cd43-4550-848b-b6243bc3fe28.apng"
	+ }

	assert {:ok, attachment} =
	AttachmentValidator.cast_and_validate(attachment)
	\|> Ecto.Changeset.apply_action(:insert)

	assert attachment.mediaType == "image/apng"
	end

	test "works with honkerific attachments" do
	attachment = %{
	"mediaType" => "",
	"name" => "",
	"summary" => "298p3RG7j27tfsZ9RQ.jpg",
	"type" => "Document",
	"url" => "https://honk.tedunangst.com/d/298p3RG7j27tfsZ9RQ.jpg"
	}

	assert {:ok, attachment} =
	AttachmentValidator.cast_and_validate(attachment)
	\|> Ecto.Changeset.apply_action(:insert)

	assert attachment.mediaType == "application/octet-stream"
	end

	test "it turns mastodon attachments into our attachments" do
	attachment = %{
	"url" =>
	"http://mastodon.example.org/system/media_attachments/files/000/000/002/original/334ce029e7bfb920.jpg",
	"type" => "Document",
	"name" => nil,
	"mediaType" => "image/jpeg",
	"blurhash" => "UD9jJz~VSbR#xT$~%KtQX9R,WAs9RjWBs:of"
	}

	{:ok, attachment} =
	AttachmentValidator.cast_and_validate(attachment)
	\|> Ecto.Changeset.apply_action(:insert)

	assert [
	%{
	href:
	"http://mastodon.example.org/system/media_attachments/files/000/000/002/original/334ce029e7bfb920.jpg",
	type: "Link",
	mediaType: "image/jpeg"
	}
	] = attachment.url

	assert attachment.mediaType == "image/jpeg"
	assert attachment.blurhash == "UD9jJz~VSbR#xT$~%KtQX9R,WAs9RjWBs:of"
	end

	test "it handles our own uploads" do
	user = insert(:user)

	file = %Plug.Upload{
	content_type: "image/jpeg",
	path: Path.absname("test/fixtures/image.jpg"),
	filename: "an_image.jpg"
	}

	{:ok, attachment} = ActivityPub.upload(file, actor: user.ap_id)

	{:ok, attachment} =
	attachment.data
	\|> AttachmentValidator.cast_and_validate()
	\|> Ecto.Changeset.apply_action(:insert)

	assert attachment.mediaType == "image/jpeg"
	end

	test "it handles image dimensions" do
	attachment = %{
	"url" => [
	%{
	"type" => "Link",
	"mediaType" => "image/jpeg",
	"href" => "https://example.com/images/1.jpg",
	"width" => 200,
	"height" => 100
	}
	],
	"type" => "Document",
	"name" => nil,
	"mediaType" => "image/jpeg"
	}

	{:ok, attachment} =
	AttachmentValidator.cast_and_validate(attachment)
	\|> Ecto.Changeset.apply_action(:insert)

	assert [
	%{
	href: "https://example.com/images/1.jpg",
	type: "Link",
	mediaType: "image/jpeg",
	width: 200,
	height: 100
	}
	] = attachment.url

	assert attachment.mediaType == "image/jpeg"
	end

	test "it transforms image dimentions to our internal format" do
	attachment = %{
	"type" => "Document",
	"name" => "Hello world",
	"url" => "https://media.example.tld/1.jpg",
	"width" => 880,
	"height" => 960,
	"mediaType" => "image/jpeg",
	"blurhash" => "eTKL26+HDjcEIBVl;ds+K6t301W.t7nit7y1E,R:v}ai4nXSt7V@of"
	}

	expected = %AttachmentValidator{
	type: "Document",
	name: "Hello world",
	mediaType: "image/jpeg",
	blurhash: "eTKL26+HDjcEIBVl;ds+K6t301W.t7nit7y1E,R:v}ai4nXSt7V@of",
	url: [
	%AttachmentValidator.UrlObjectValidator{
	type: "Link",
	mediaType: "image/jpeg",
	href: "https://media.example.tld/1.jpg",
	width: 880,
	height: 960
	}
	]
	}

	{:ok, ^expected} =
	AttachmentValidator.cast_and_validate(attachment)
	\|> Ecto.Changeset.apply_action(:insert)
	end
	end
	end
	diff --git a/test/support/factory.ex b/test/support/factory.ex
	index e21b8fc1e..2a73a4ae6 100644
	--- a/test/support/factory.ex
	+++ b/test/support/factory.ex
	@@ -1,779 +1,778 @@
	# Pleroma: A lightweight social networking server
	# Copyright © 2017-2021 Pleroma Authors <https://pleroma.social/>
	# SPDX-License-Identifier: AGPL-3.0-only

	defmodule Pleroma.Factory do
	use ExMachina.Ecto, repo: Pleroma.Repo

	require Pleroma.Constants

	alias Pleroma.Object
	alias Pleroma.User
	alias Pleroma.Web.ActivityPub.UserView

	@rsa_keys [
	"test/fixtures/rsa_keys/key_1.pem",
	"test/fixtures/rsa_keys/key_2.pem",
	"test/fixtures/rsa_keys/key_3.pem",
	"test/fixtures/rsa_keys/key_4.pem",
	"test/fixtures/rsa_keys/key_5.pem"
	]
	\|> Enum.map(&File.read!/1)

	def participation_factory do
	conversation = insert(:conversation)
	user = insert(:user)

	%Pleroma.Conversation.Participation{
	conversation: conversation,
	user: user,
	read: false
	}
	end

	def conversation_factory do
	%Pleroma.Conversation{
	ap_id: sequence(:ap_id, &"https://some_conversation/#{&1}")
	}
	end

	def instance_factory(attrs \\ %{}) do
	%Pleroma.Instances.Instance{
	host: attrs[:domain] \|\| "example.com",
	nodeinfo: %{version: "2.0", openRegistrations: true},
	unreachable_since: nil
	}
	\|> Map.merge(attrs)
	end

	def user_factory(attrs \\ %{}) do
	pem = Enum.random(@rsa_keys)
	# Argon2.hash_pwd_salt("test")
	# it really eats CPU time, so we use a precomputed hash
	password_hash =
	"$argon2id$v=19$m=65536,t=8,p=2$FEAarFuiOsROO24NHIHMYw$oxdaz2fTPpuU+dYCl60FsqE65T1Tjy6lGikKfmql4xo"

	user = %User{
	name: sequence(:name, &"Test テスト User #{&1}"),
	email: sequence(:email, &"user#{&1}@example.com"),
	nickname: sequence(:nickname, &"nick#{&1}"),
	password_hash: password_hash,
	bio: sequence(:bio, &"Tester Number #{&1}"),
	is_discoverable: true,
	last_digest_emailed_at: NaiveDateTime.utc_now(),
	last_refreshed_at: NaiveDateTime.utc_now(),
	notification_settings: %Pleroma.User.NotificationSetting{},
	multi_factor_authentication_settings: %Pleroma.MFA.Settings{},
	ap_enabled: true,
	keys: pem
	}

	urls =
	if attrs[:local] == false do
	base_domain = attrs[:domain] \|\| Enum.random(["domain1.com", "domain2.com", "domain3.com"])

	ap_id = "https://#{base_domain}/users/#{user.nickname}"

	%{
	ap_id: ap_id,
	follower_address: ap_id <> "/followers",
	following_address: ap_id <> "/following",
	featured_address: ap_id <> "/collections/featured"
	}
	else
	%{
	ap_id: User.ap_id(user),
	follower_address: User.ap_followers(user),
	following_address: User.ap_following(user),
	featured_address: User.ap_featured_collection(user)
	}
	end

	attrs = Map.delete(attrs, :domain)

	user
	\|> Map.put(:raw_bio, user.bio)
	\|> Map.merge(urls)
	\|> merge_attributes(attrs)
	end

	def user_relationship_factory(attrs \\ %{}) do
	source = attrs[:source] \|\| insert(:user)
	target = attrs[:target] \|\| insert(:user)
	relationship_type = attrs[:relationship_type] \|\| :block

	%Pleroma.UserRelationship{
	source_id: source.id,
	target_id: target.id,
	relationship_type: relationship_type
	}
	end

	def note_factory(attrs \\ %{}) do
	text = sequence(:text, &"This is :moominmamma: note #{&1}")

	user = attrs[:user] \|\| insert(:user)

	data = %{
	"type" => "Note",
	"content" => text,
	"source" => text,
	"id" => Pleroma.Web.ActivityPub.Utils.generate_object_id(),
	"actor" => user.ap_id,
	"to" => ["https://www.w3.org/ns/activitystreams#Public"],
	"published" => DateTime.utc_now() \|> DateTime.to_iso8601(),
	"likes" => [],
	"like_count" => 0,
	"context" => "2hu",
	"summary" => "2hu",
	"tag" => ["2hu"],
	"emoji" => %{
	"2hu" => "corndog.png"
	}
	}

	%Pleroma.Object{
	data: merge_attributes(data, Map.get(attrs, :data, %{}))
	}
	end

	def attachment_factory(attrs \\ %{}) do
	user = attrs[:user] \|\| insert(:user)

	data =
	attachment_data(user.ap_id, nil)
	\|> Map.put("id", Pleroma.Web.ActivityPub.Utils.generate_object_id())

	%Pleroma.Object{
	data: merge_attributes(data, Map.get(attrs, :data, %{}))
	}
	end

	def attachment_note_factory(attrs \\ %{}) do
	user = attrs[:user] \|\| insert(:user)
	{length, attrs} = Map.pop(attrs, :length, 1)

	data = %{
	"attachment" =>
	Stream.repeatedly(fn -> attachment_data(user.ap_id, attrs[:href]) end)
	\|> Enum.take(length)
	}

	build(:note, Map.put(attrs, :data, data))
	end

	defp attachment_data(ap_id, href) do
	href = href \|\| sequence(:href, &"#{Pleroma.Web.Endpoint.url()}/media/#{&1}.jpg")

	%{
	"url" => [
	%{
	"href" => href,
	"type" => "Link",
	"mediaType" => "image/jpeg"
	}
	],
	"name" => "some name",
	"type" => "Document",
	"actor" => ap_id,
	"mediaType" => "image/jpeg"
	}
	end

	def followers_only_note_factory(attrs \\ %{}) do
	%Pleroma.Object{data: data} = note_factory(attrs)
	%Pleroma.Object{data: Map.merge(data, %{"to" => [data["actor"] <> "/followers"]})}
	end

	def audio_factory(attrs \\ %{}) do
	text = sequence(:text, &"lain radio episode #{&1}")

	user = attrs[:user] \|\| insert(:user)

	data = %{
	"type" => "Audio",
	"id" => Pleroma.Web.ActivityPub.Utils.generate_object_id(),
	"artist" => "lain",
	"title" => text,
	"album" => "lain radio",
	"to" => ["https://www.w3.org/ns/activitystreams#Public"],
	"published" => DateTime.utc_now() \|> DateTime.to_iso8601(),
	"actor" => user.ap_id,
	"length" => 180_000
	}

	%Pleroma.Object{
	data: merge_attributes(data, Map.get(attrs, :data, %{}))
	}
	end

	def listen_factory do
	audio = insert(:audio)

	data = %{
	"id" => Pleroma.Web.ActivityPub.Utils.generate_activity_id(),
	"type" => "Listen",
	"actor" => audio.data["actor"],
	"to" => audio.data["to"],
	"object" => audio.data,
	"published" => audio.data["published"]
	}

	%Pleroma.Activity{
	data: data,
	actor: data["actor"],
	recipients: data["to"]
	}
	end

	def direct_note_factory do
	user2 = insert(:user)

	%Pleroma.Object{data: data} = note_factory()
	%Pleroma.Object{data: Map.merge(data, %{"to" => [user2.ap_id]})}
	end

	def article_factory do
	%Pleroma.Object{data: data} = note_factory()
	%Pleroma.Object{data: Map.merge(data, %{"type" => "Article"})}
	end

	def tombstone_factory(attrs) do
	data = %{
	"type" => "Tombstone",
	"id" => Pleroma.Web.ActivityPub.Utils.generate_object_id(),
	"formerType" => "Note",
	"deleted" => DateTime.utc_now() \|> DateTime.to_iso8601()
	}

	%Pleroma.Object{
	data: data
	}
	\|> merge_attributes(attrs)
	end

	def question_factory(attrs \\ %{}) do
	user = attrs[:user] \|\| insert(:user)

	data = %{
	"id" => Pleroma.Web.ActivityPub.Utils.generate_object_id(),
	"type" => "Question",
	"actor" => user.ap_id,
	"attributedTo" => user.ap_id,
	"attachment" => [],
	"to" => ["https://www.w3.org/ns/activitystreams#Public"],
	"cc" => [user.follower_address],
	"context" => Pleroma.Web.ActivityPub.Utils.generate_context_id(),
	"closed" => DateTime.utc_now() \|> DateTime.add(86_400) \|> DateTime.to_iso8601(),
	"oneOf" => [
	%{
	"type" => "Note",
	"name" => "chocolate",
	"replies" => %{"totalItems" => 0, "type" => "Collection"}
	},
	%{
	"type" => "Note",
	"name" => "vanilla",
	"replies" => %{"totalItems" => 0, "type" => "Collection"}
	}
	]
	}

	%Pleroma.Object{
	data: merge_attributes(data, Map.get(attrs, :data, %{}))
	}
	end

	def direct_note_activity_factory do
	dm = insert(:direct_note)

	data = %{
	"id" => Pleroma.Web.ActivityPub.Utils.generate_activity_id(),
	"type" => "Create",
	"actor" => dm.data["actor"],
	"to" => dm.data["to"],
	"object" => dm.data,
	"published" => DateTime.utc_now() \|> DateTime.to_iso8601(),
	"context" => dm.data["context"]
	}

	%Pleroma.Activity{
	data: data,
	actor: data["actor"],
	recipients: data["to"]
	}
	end

	def add_activity_factory(attrs \\ %{}) do
	featured_collection_activity(attrs, "Add")
	end

	def remove_activity_factory(attrs \\ %{}) do
	featured_collection_activity(attrs, "Remove")
	end

	defp featured_collection_activity(attrs, type) do
	user = attrs[:user] \|\| insert(:user)
	note = attrs[:note] \|\| insert(:note, user: user)

	data_attrs =
	attrs
	\|> Map.get(:data_attrs, %{})
	\|> Map.put(:type, type)

	attrs = Map.drop(attrs, [:user, :note, :data_attrs])

	data =
	%{
	"id" => Pleroma.Web.ActivityPub.Utils.generate_activity_id(),
	"target" => user.featured_address,
	"object" => note.data["object"],
	"actor" => note.data["actor"],
	"type" => type,
	"to" => [Pleroma.Constants.as_public()],
	"cc" => [user.follower_address]
	}
	\|> Map.merge(data_attrs)

	%Pleroma.Activity{
	data: data,
	actor: data["actor"],
	recipients: data["to"]
	}
	\|> Map.merge(attrs)
	end

	def followers_only_note_activity_factory(attrs \\ %{}) do
	user = attrs[:user] \|\| insert(:user)
	note = insert(:followers_only_note, user: user)

	data_attrs = attrs[:data_attrs] \|\| %{}
	attrs = Map.drop(attrs, [:user, :note, :data_attrs])

	data =
	%{
	"id" => Pleroma.Web.ActivityPub.Utils.generate_activity_id(),
	"type" => "Create",
	"actor" => note.data["actor"],
	"to" => note.data["to"],
	"object" => note.data,
	"published" => DateTime.utc_now() \|> DateTime.to_iso8601(),
	"context" => note.data["context"]
	}
	\|> Map.merge(data_attrs)

	%Pleroma.Activity{
	data: data,
	actor: data["actor"],
	recipients: data["to"]
	}
	\|> Map.merge(attrs)
	end

	def note_activity_factory(attrs \\ %{}) do
	user = attrs[:user] \|\| insert(:user)
	note = attrs[:note] \|\| insert(:note, user: user)

	data_attrs = attrs[:data_attrs] \|\| %{}
	attrs = Map.drop(attrs, [:user, :note, :data_attrs])

	data =
	%{
	"id" => Pleroma.Web.ActivityPub.Utils.generate_activity_id(),
	"type" => "Create",
	"actor" => note.data["actor"],
	"to" => note.data["to"],
	"object" => note.data["id"],
	"published" => DateTime.utc_now() \|> DateTime.to_iso8601(),
	"context" => note.data["context"]
	}
	\|> Map.merge(data_attrs)

	%Pleroma.Activity{
	data: data,
	actor: data["actor"],
	recipients: data["to"]
	}
	\|> Map.merge(attrs)
	end

	def article_activity_factory do
	article = insert(:article)

	data = %{
	"id" => Pleroma.Web.ActivityPub.Utils.generate_activity_id(),
	"type" => "Create",
	"actor" => article.data["actor"],
	"to" => article.data["to"],
	"object" => article.data,
	"published" => DateTime.utc_now() \|> DateTime.to_iso8601(),
	"context" => article.data["context"]
	}

	%Pleroma.Activity{
	data: data,
	actor: data["actor"],
	recipients: data["to"]
	}
	end

	def announce_activity_factory(attrs \\ %{}) do
	note_activity = attrs[:note_activity] \|\| insert(:note_activity)
	user = attrs[:user] \|\| insert(:user)

	data = %{
	"type" => "Announce",
	"actor" => note_activity.actor,
	"object" => note_activity.data["id"],
	"to" => [user.follower_address, note_activity.data["actor"]],
	"cc" => ["https://www.w3.org/ns/activitystreams#Public"],
	"context" => note_activity.data["context"]
	}

	%Pleroma.Activity{
	data: data,
	actor: user.ap_id,
	recipients: data["to"]
	}
	end

	def like_activity_factory(attrs \\ %{}) do
	note_activity = attrs[:note_activity] \|\| insert(:note_activity)
	object = Object.normalize(note_activity, fetch: false)
	user = insert(:user)

	data =
	%{
	"id" => Pleroma.Web.ActivityPub.Utils.generate_activity_id(),
	"actor" => user.ap_id,
	"type" => "Like",
	"object" => object.data["id"],
	"published_at" => DateTime.utc_now() \|> DateTime.to_iso8601()
	}
	\|> Map.merge(attrs[:data_attrs] \|\| %{})

	%Pleroma.Activity{
	data: data
	}
	end

	def follow_activity_factory(attrs \\ %{}) do
	follower = attrs[:follower] \|\| insert(:user)
	followed = attrs[:followed] \|\| insert(:user)

	data = %{
	"id" => Pleroma.Web.ActivityPub.Utils.generate_activity_id(),
	"actor" => follower.ap_id,
	"type" => "Follow",
	"object" => followed.ap_id,
	"state" => attrs[:state] \|\| "pending",
	"published_at" => DateTime.utc_now() \|> DateTime.to_iso8601()
	}

	%Pleroma.Activity{
	data: data,
	actor: follower.ap_id
	}
	\|> Map.merge(attrs)
	end

	def report_activity_factory(attrs \\ %{}) do
	user = attrs[:user] \|\| insert(:user)
	activity = attrs[:activity] \|\| insert(:note_activity)
	state = attrs[:state] \|\| "open"

	data = %{
	"id" => Pleroma.Web.ActivityPub.Utils.generate_activity_id(),
	"actor" => user.ap_id,
	"type" => "Flag",
	"object" => [activity.actor, activity.data["id"]],
	"published" => DateTime.utc_now() \|> DateTime.to_iso8601(),
	"to" => [],
	"cc" => [activity.actor],
	"context" => activity.data["context"],
	"state" => state
	}

	%Pleroma.Activity{
	data: data,
	actor: data["actor"],
	recipients: data["to"] ++ data["cc"]
	}
	end

	def question_activity_factory(attrs \\ %{}) do
	user = attrs[:user] \|\| insert(:user)
	question = attrs[:question] \|\| insert(:question, user: user)

	data_attrs = attrs[:data_attrs] \|\| %{}
	attrs = Map.drop(attrs, [:user, :question, :data_attrs])

	data =
	%{
	"id" => Pleroma.Web.ActivityPub.Utils.generate_activity_id(),
	"type" => "Create",
	"actor" => question.data["actor"],
	"to" => question.data["to"],
	"object" => question.data["id"],
	"published" => DateTime.utc_now() \|> DateTime.to_iso8601(),
	"context" => question.data["context"]
	}
	\|> Map.merge(data_attrs)

	%Pleroma.Activity{
	data: data,
	actor: data["actor"],
	recipients: data["to"]
	}
	\|> Map.merge(attrs)
	end

	def delete_activity_factory(attrs \\ %{}) do
	user = attrs[:user] \|\| insert(:user)
	note_activity = attrs[:note_activity] \|\| insert(:note_activity, user: user)

	data_attrs = attrs[:data_attrs] \|\| %{}
	attrs = Map.drop(attrs, [:user, :data_attrs])

	data =
	%{
	"id" => Pleroma.Web.ActivityPub.Utils.generate_activity_id(),
	"type" => "Delete",
	"actor" => note_activity.data["actor"],
	"to" => note_activity.data["to"],
	"object" => note_activity.data["id"],
	"published" => DateTime.utc_now() \|> DateTime.to_iso8601(),
	"context" => note_activity.data["context"]
	}
	\|> Map.merge(data_attrs)

	%Pleroma.Activity{
	data: data,
	actor: data["actor"],
	recipients: data["to"]
	}
	\|> Map.merge(attrs)
	end

	def undo_activity_factory(attrs \\ %{}) do
	like_activity = attrs[:like_activity] \|\| insert(:like_activity)
	attrs = Map.drop(attrs, [:like_activity])

	- data =
	- %{
	- "id" => Pleroma.Web.ActivityPub.Utils.generate_activity_id(),
	- "type" => "Undo",
	- "actor" => like_activity.data["actor"],
	- "to" => like_activity.data["to"],
	- "object" => like_activity.data["id"],
	- "published" => DateTime.utc_now() \|> DateTime.to_iso8601(),
	- "context" => like_activity.data["context"]
	- }
	+ data = %{
	+ "id" => Pleroma.Web.ActivityPub.Utils.generate_activity_id(),
	+ "type" => "Undo",
	+ "actor" => like_activity.data["actor"],
	+ "to" => like_activity.data["to"],
	+ "object" => like_activity.data["id"],
	+ "published" => DateTime.utc_now() \|> DateTime.to_iso8601(),
	+ "context" => like_activity.data["context"]
	+ }

	%Pleroma.Activity{
	data: data,
	actor: data["actor"],
	recipients: data["to"]
	}
	\|> Map.merge(attrs)
	end

	def update_activity_factory(attrs \\ %{}) do
	user = attrs[:user] \|\| insert(:user, nickname: "testuser")
	attrs = Map.drop(attrs, [:user])

	user_data =
	UserView.render("user.json", %{user: user})
	\|> Map.merge(%{"name" => "new display name"})

	data = %{
	"type" => "Update",
	"to" => [
	user_data["followers"],
	"https://www.w3.org/ns/activitystreams#Public"
	],
	"actor" => user_data["id"],
	"object" => user_data
	}

	%Pleroma.Activity{
	actor: user_data["id"],
	data: data
	}
	\|> Map.merge(attrs)
	end

	def oauth_app_factory do
	%Pleroma.Web.OAuth.App{
	client_name: sequence(:client_name, &"Some client #{&1}"),
	redirect_uris: "https://example.com/callback",
	scopes: ["read", "write", "follow", "push"],
	website: "https://example.com",
	client_id: Ecto.UUID.generate(),
	client_secret: "aaa;/&bbb"
	}
	end

	def oauth_token_factory(attrs \\ %{}) do
	scopes = Map.get(attrs, :scopes, ["read"])
	oauth_app = Map.get_lazy(attrs, :app, fn -> insert(:oauth_app, scopes: scopes) end)
	user = Map.get_lazy(attrs, :user, fn -> build(:user) end)

	valid_until =
	Map.get(attrs, :valid_until, NaiveDateTime.add(NaiveDateTime.utc_now(), 60 * 10))

	%Pleroma.Web.OAuth.Token{
	token: :crypto.strong_rand_bytes(32) \|> Base.url_encode64(),
	refresh_token: :crypto.strong_rand_bytes(32) \|> Base.url_encode64(),
	scopes: scopes,
	user: user,
	app: oauth_app,
	valid_until: valid_until
	}
	end

	def oauth_admin_token_factory(attrs \\ %{}) do
	user = Map.get_lazy(attrs, :user, fn -> build(:user, is_admin: true) end)

	scopes =
	attrs
	\|> Map.get(:scopes, ["admin"])
	\|> Kernel.++(["admin"])
	\|> Enum.uniq()

	attrs = Map.merge(attrs, %{user: user, scopes: scopes})
	oauth_token_factory(attrs)
	end

	def oauth_authorization_factory do
	%Pleroma.Web.OAuth.Authorization{
	token: :crypto.strong_rand_bytes(32) \|> Base.url_encode64(padding: false),
	scopes: ["read", "write", "follow", "push"],
	valid_until: NaiveDateTime.add(NaiveDateTime.utc_now(), 60 * 10),
	user: build(:user),
	app: build(:oauth_app)
	}
	end

	def push_subscription_factory do
	%Pleroma.Web.Push.Subscription{
	user: build(:user),
	token: build(:oauth_token),
	endpoint: "https://example.com/example/1234",
	key_auth: "8eDyX_uCN0XRhSbY5hs7Hg==",
	key_p256dh:
	"BCIWgsnyXDv1VkhqL2P7YRBvdeuDnlwAPT2guNhdIoW3IP7GmHh1SMKPLxRf7x8vJy6ZFK3ol2ohgn_-0yP7QQA=",
	data: %{}
	}
	end

	def notification_factory do
	%Pleroma.Notification{
	user: build(:user)
	}
	end

	def scheduled_activity_factory do
	%Pleroma.ScheduledActivity{
	user: build(:user),
	scheduled_at: NaiveDateTime.add(NaiveDateTime.utc_now(), :timer.minutes(60), :millisecond),
	params: build(:note) \|> Map.from_struct() \|> Map.get(:data)
	}
	end

	def registration_factory do
	user = insert(:user)

	%Pleroma.Registration{
	user: user,
	provider: "twitter",
	uid: "171799000",
	info: %{
	"name" => "John Doe",
	"email" => "john@doe.com",
	"nickname" => "johndoe",
	"description" => "My bio"
	}
	}
	end

	def config_factory(attrs \\ %{}) do
	%Pleroma.ConfigDB{
	key: sequence(:key, &String.to_atom("some_key_#{&1}")),
	group: :pleroma,
	value:
	sequence(
	:value,
	&%{another_key: "#{&1}somevalue", another: "#{&1}somevalue"}
	)
	}
	\|> merge_attributes(attrs)
	end

	def marker_factory do
	%Pleroma.Marker{
	user: build(:user),
	timeline: "notifications",
	lock_version: 0,
	last_read_id: "1"
	}
	end

	def mfa_token_factory do
	%Pleroma.MFA.Token{
	token: :crypto.strong_rand_bytes(32) \|> Base.url_encode64(padding: false),
	authorization: build(:oauth_authorization),
	valid_until: NaiveDateTime.add(NaiveDateTime.utc_now(), 60 * 10),
	user: build(:user)
	}
	end

	def filter_factory do
	%Pleroma.Filter{
	user: build(:user),
	filter_id: sequence(:filter_id, & &1),
	phrase: "cofe",
	context: ["home"]
	}
	end

	def announcement_factory(params \\ %{}) do
	data = Map.get(params, :data, %{})

	{_, params} = Map.pop(params, :data)

	%Pleroma.Announcement{
	data: Map.merge(%{"content" => "test announcement", "all_day" => false}, data)
	}
	\|> Map.merge(params)
	\|> Pleroma.Announcement.add_rendered_properties()
	end

	def frontend_setting_profile_factory(params \\ %{}) do
	%Pleroma.Akkoma.FrontendSettingsProfile{
	user: build(:user),
	frontend_name: "akkoma-fe",
	profile_name: "default",
	settings: %{"test" => "test"},
	version: 1
	}
	\|> Map.merge(params)
	end

	def delivery_factory(params \\ %{}) do
	object = Map.get(params, :object, build(:note))
	user = Map.get(params, :user, build(:user))

	%Pleroma.Delivery{
	object: object,
	user: user
	}
	end

	def hashtag_factory(params \\ %{}) do
	%Pleroma.Hashtag{
	name: "test #{sequence(:hashtag_name, & &1)}"
	}
	\|> Map.merge(params)
	end
	end

File Metadata

Mime Type: text/x-diff
Expires: Sun, Aug 9, 3:03 AM (1 d, 19 h)
Storage Engine: blob
Storage Format: Raw Data
Storage Handle: 1724146
Default Alt Text: (261 KB)

No OneTemporaryActions

View Options

File Metadata

Event Timeline

No OneTemporary
Actions