Docs: Revert formatting changes, adapted more notes/warning to mkdocs, rephrased a few phrases
ci/woodpecker/pr/woodpecker Pipeline is pending
Details
ci/woodpecker/pr/woodpecker Pipeline is pending
Details
This commit is contained in:
parent
7cf6b40dc5
commit
457661a316
|
@ -4,7 +4,7 @@
|
|||
|
||||
## Transfer config from file to DB.
|
||||
|
||||
!!! Note
|
||||
!!! note
|
||||
You need to add the following to your config before executing this command:
|
||||
|
||||
```elixir
|
||||
|
@ -25,7 +25,7 @@
|
|||
|
||||
## Transfer config from DB to `config/env.exported_from_db.secret.exs`
|
||||
|
||||
!!! Note
|
||||
!!! note
|
||||
In-Database configuration will still be applied after executing this command unless you set the following in your config:
|
||||
|
||||
```elixir
|
||||
|
@ -179,8 +179,8 @@ it may be easier to dump the values to JSON and then modify them in a text edito
|
|||
|
||||
## Loading specific configuration values from JSON
|
||||
|
||||
**Note:** This will overwrite any existing value in the database, and can
|
||||
cause crashes if you do not have exactly the correct formatting.
|
||||
!!! note
|
||||
This will overwrite any existing value in the database, and can cause crashes if you do not have exactly the correct formatting.
|
||||
|
||||
Once you have modified the JSON file, you can load it back into the database.
|
||||
|
||||
|
|
|
@ -2,7 +2,7 @@
|
|||
|
||||
{! administration/CLI_tasks/general_cli_task_info.include !}
|
||||
|
||||
!!! Danger
|
||||
!!! danger
|
||||
These mix tasks can take a long time to complete. Many of them were written to address specific database issues that happened because of bugs in migrations or other specific scenarios. Do not run these tasks "just in case" if everything is fine your instance.
|
||||
|
||||
## Replace embedded objects with their references
|
||||
|
@ -99,7 +99,7 @@ Can be safely re-run
|
|||
|
||||
## Vacuum the database
|
||||
|
||||
!!! Note
|
||||
!!! note
|
||||
By default, PostgreSQL has an autovacuum daemon running. While the tasks described here can help in some cases, they shouldn't be needed on a regular basis. See [the PostgreSQL docs on vacuuming](https://www.postgresql.org/docs/current/sql-vacuum.html) for more information on this.
|
||||
|
||||
### Analyze
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
Every command should be ran as the `akkoma` user from its home directory. For example, if you are superuser, you would have to wrap the command in `su akkoma -s $SHELL -lc "$COMMAND"`.
|
||||
|
||||
??? Note "From source note about `MIX_ENV`"
|
||||
??? note "From source note about `MIX_ENV`"
|
||||
|
||||
The `mix` command should be prefixed with the name of the environment your Akkoma server is running in, usually it's `MIX_ENV=prod`
|
||||
|
|
|
@ -3,7 +3,7 @@
|
|||
If you run Akkoma, you may be inclined to collect metrics to ensure your instance is running smoothly,
|
||||
and that there's nothing quietly failing in the background.
|
||||
|
||||
To facilitate this, Akkoma exposes Prometheus metrics to be scrapped.
|
||||
To facilitate this, Akkoma exposes Prometheus metrics to be scraped.
|
||||
|
||||
## Prometheus
|
||||
|
||||
|
|
|
@ -1,6 +1,6 @@
|
|||
# Akkoma Clients
|
||||
Note: Additional clients may work, but these are known to work with Akkoma.
|
||||
Apps listed here might not support all of Akkoma's features.
|
||||
!!! note
|
||||
Additional clients may work, but these are known to work with Akkoma. Apps listed here might not support all of Akkoma's features.
|
||||
|
||||
## Desktop
|
||||
### Whalebird
|
||||
|
|
|
@ -130,7 +130,7 @@ To add configuration to your config file, you can copy it from the base config.
|
|||
## Federation
|
||||
### MRF policies
|
||||
|
||||
!!! Note
|
||||
!!! 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
|
||||
|
@ -414,7 +414,7 @@ config :pleroma, Pleroma.Web.MediaProxy.Invalidation.Http,
|
|||
### :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 to parse metadata. Default is ["local", "localdomain", "lan"].
|
||||
* `ignore_tld`: list of TLDs (top-level domains) which will be ignored by the metadata parser. 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.
|
||||
|
||||
|
@ -422,7 +422,7 @@ config :pleroma, Pleroma.Web.MediaProxy.Invalidation.Http,
|
|||
|
||||
### Pleroma.Web.Endpoint
|
||||
|
||||
!!! Note
|
||||
!!! 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).
|
||||
|
@ -456,7 +456,7 @@ This will make Akkoma listen on `127.0.0.1` port `8080` and generate URLs starti
|
|||
|
||||
### Pleroma.Web.Plugs.RemoteIp
|
||||
|
||||
!!! Warning
|
||||
!!! 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.
|
||||
|
@ -470,7 +470,7 @@ Available options:
|
|||
|
||||
### :rate_limit
|
||||
|
||||
!!! Note
|
||||
!!! 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:
|
||||
|
@ -561,7 +561,7 @@ the source code is here: [kocaptcha](https://github.com/koto-bank/kocaptcha). Th
|
|||
* `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
|
||||
!!! warning
|
||||
`strip_exif` has been replaced by `Pleroma.Upload.Filter.Mogrify`.
|
||||
|
||||
### Uploaders
|
||||
|
@ -620,9 +620,9 @@ No specific configuration.
|
|||
## 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.
|
||||
* `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 to enable/disable send emails. Default: `false`.
|
||||
* `enabled`: Allows your instance to send emails. Default: `false`.
|
||||
|
||||
An example for SendGrid adapter:
|
||||
|
||||
|
@ -789,7 +789,7 @@ config :logger, :ex_syslogger,
|
|||
|
||||
### RUM indexing for full text search
|
||||
|
||||
!!! Warning
|
||||
!!! 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`.
|
||||
|
@ -826,7 +826,8 @@ or
|
|||
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.
|
||||
!!! 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
|
||||
|
||||
|
@ -883,13 +884,13 @@ OAuth 2.0 provider and related endpoints:
|
|||
OAuth's consumer mode allows sign in / sign up via external OAuth providers (e.g. Twitter, Facebook, Google, Microsoft, etc.).
|
||||
Implementation is based on Überauth; see the list of [available strategies](https://github.com/ueberauth/ueberauth/wiki/List-of-Strategies).
|
||||
|
||||
!!! Note
|
||||
!!! 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
|
||||
!!! note
|
||||
Each strategy requires separate setup (on external provider side and Akkoma side). Below are the guidelines on setting up most popular strategies.
|
||||
|
||||
!!! Note
|
||||
!!! note
|
||||
Make sure that `"SameSite=Lax"` is set in `extra_cookie_attrs` when you have this feature enabled. OAuth's 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
|
||||
|
@ -1070,7 +1071,7 @@ Control favicons for instances.
|
|||
|
||||
## Pleroma.User.Backup
|
||||
|
||||
!!! Note
|
||||
!!! note
|
||||
Requires enabled email
|
||||
|
||||
* `:purge_after_days` an integer, remove backup archives after N days.
|
||||
|
|
|
@ -42,7 +42,8 @@ The configuration of Akkoma (and Pleroma) has traditionally been managed with a
|
|||
config :pleroma, configurable_from_database: true
|
||||
```
|
||||
|
||||
4. ⚠️ **THIS IS NOT REQUIRED** ⚠️
|
||||
!!! note
|
||||
This step is not required
|
||||
|
||||
Now you can edit your config file and strip it down to the only settings which are not possible to control in the database. e.g., the PostgreSQL (Repo) and webserver (Endpoint) settings cannot be controlled in the database because the application needs the settings to start up and access the database.
|
||||
|
||||
|
|
|
@ -32,7 +32,8 @@ Check the output of the query, and see if it matches your expectation.
|
|||
mix pleroma.database set_text_search_config YOUR.CONFIG
|
||||
```
|
||||
|
||||
Note: index update may take a while, and it can be done while the instance is up and running, so you may restart db connection as soon as you see `Recreate index` in task output.
|
||||
!!! note
|
||||
Index update may take a while, and it can be done while the instance is up and running, so you may restart db connection as soon as you see `Recreate index` in task output.
|
||||
|
||||
## Restart database connection
|
||||
Since some changes above will only apply with a new database connection, you will have to restart either Akkoma or PostgreSQL process, or use `pg_terminate_backend` SQL command without restarting either.
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
# How to set rich media cache TTL based on image TTL
|
||||
## Explanation
|
||||
|
||||
Richmedia are cached without the TTL, but the rich media may have image which can expire, like AWS-signed URL.
|
||||
Rich media is cached without the TTL, but the rich media may have an image which can expire, like AWS-signed URL.
|
||||
In such cases, the old image URL (expired) is returned from the media cache.
|
||||
|
||||
So, to avoid such situation, we can define a module that will set TTL based on image.
|
||||
|
|
|
@ -15,7 +15,8 @@ One using the config, and one using external software (fedproxy). The external s
|
|||
|
||||
### Using the Config
|
||||
|
||||
**Warning:** So far, everytime I followed this way of federating using I2P, the rest of my federation stopped working. I'm leaving this here in case it will help with making it work.
|
||||
!!! warning
|
||||
So far, everytime I followed this way of federating using I2P, the rest of my federation stopped working. I'm leaving this here in case it will help with making it work.
|
||||
|
||||
Assuming you're running in prod, `cd` to your Akkoma folder and append the following to `config/prod.secret.exs`:
|
||||
```
|
||||
|
|
|
@ -12,7 +12,8 @@ To install Tor on Debian / Ubuntu:
|
|||
apt -yq install tor
|
||||
```
|
||||
|
||||
**WARNING:** Onion instances not using a Tor version supporting V3 addresses will not be able to federate with you.
|
||||
!!! warning
|
||||
Onion instances not using a Tor version supporting V3 addresses will not be able to federate with you.
|
||||
|
||||
Create the hidden service for your Akkoma instance in `/etc/tor/torrc`, with an HTTP tunnel:
|
||||
```
|
||||
|
|
|
@ -124,7 +124,8 @@ depends on the amount of text in posts.
|
|||
|
||||
## Elasticsearch
|
||||
|
||||
**Note: This requires at least Elasticsearch 7**
|
||||
!!! note
|
||||
This requires at least Elasticsearch 7
|
||||
|
||||
As with Meilisearch, this can be rather memory-hungry, but it is very good at what it does.
|
||||
|
||||
|
|
|
@ -66,7 +66,7 @@ config :pleroma, :frontend_configurations,
|
|||
|
||||
## Logo
|
||||
|
||||
!!! Important
|
||||
!!! important
|
||||
Note the extra `static` folder for the default logo.png location
|
||||
|
||||
If you want to give a brand to your instance, you can change the logo of your instance by uploading it to the static directory `$static_dir/static/logo.png`.
|
||||
|
@ -84,7 +84,7 @@ config :pleroma, :frontend_configurations,
|
|||
|
||||
## Terms of Service
|
||||
|
||||
!!! Important
|
||||
!!! important
|
||||
Note the extra `static` folder for the terms-of-service.html
|
||||
|
||||
Terms of Service will be shown to all users on the registration page. It's the best place where to write down the rules for your instance. You can modify the rules by adding and changing `$static_dir/static/terms-of-service.html`.
|
||||
|
|
|
@ -151,7 +151,8 @@ Backwards-compatibility for admin API endpoints without version prefixes (`/api/
|
|||
|
||||
## `GET /api/v1/pleroma/admin/users/:nickname/permission_group/:permission_group`
|
||||
|
||||
Note: Available `:permission_group` is currently moderator and admin. 404 is returned when the permission group doesn’t exist.
|
||||
!!! note
|
||||
Available `:permission_group` is currently moderator and admin. 404 is returned when the permission group doesn’t exist.
|
||||
|
||||
### Get user permission groups membership per permission group
|
||||
|
||||
|
@ -363,8 +364,8 @@ Removes the user(s) from follower recommendations.
|
|||
|
||||
### Delete all users and activities from a remote instance
|
||||
|
||||
Note: this will trigger a job to remove instance content in the background.
|
||||
It may take some time.
|
||||
!!! note
|
||||
This will trigger a job to remove instance content in the background. It may take some time.
|
||||
|
||||
- Params:
|
||||
- `instance`: remote instance host
|
||||
|
|
|
@ -1,4 +1,5 @@
|
|||
**Note:** Akkoma documentation is still being updated, so you may still see references to Pleroma in many places.
|
||||
!!! note
|
||||
Akkoma documentation is still being updated, so you may still see references to Pleroma in many places.
|
||||
|
||||
# Introduction to Akkoma
|
||||
## What is Akkoma?
|
||||
|
|
|
@ -111,7 +111,8 @@ su akkoma -s $SHELL -lc "./bin/pleroma stop"
|
|||
## Setting up a system service
|
||||
OTP releases have different service files than from-source installs, so they need to be copied over again.
|
||||
|
||||
**Warning:** The service files assume Akkoma user's home directory is `/opt/akkoma`, please make sure all paths fit your installation.
|
||||
!!! warning
|
||||
The service files assume Akkoma user's home directory is `/opt/akkoma`, please make sure all paths fit your installation.
|
||||
|
||||
=== "Alpine"
|
||||
```sh
|
||||
|
|
|
@ -137,8 +137,8 @@ ln -s /etc/ssl/private/<domain name>.key /etc/ssl/private/<IP address>.key
|
|||
```
|
||||
This will have to be done for each IPv4 and IPv6 address relayd listens on.
|
||||
|
||||
#### relayd
|
||||
relayd will be used as the reverse proxy sitting in front of Akkoma.
|
||||
#### Relayd
|
||||
Relayd will be used as the reverse proxy sitting in front of Akkoma.
|
||||
Insert the following configuration in `/etc/relayd.conf`:
|
||||
```
|
||||
# $OpenBSD: relayd.conf,v 1.4 2018/03/23 09:55:06 claudio Exp $
|
||||
|
|
|
@ -7,7 +7,8 @@ For specific Pleroma functionality (which is disabled by default) some or all of
|
|||
|
||||
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 Pleroma.
|
||||
!!! note
|
||||
The packages are not required with the current default settings of Pleroma.
|
||||
|
||||
## `ImageMagick`
|
||||
|
||||
|
|
|
@ -75,7 +75,7 @@ Per [`docs/installation/optional/media_graphics_packages.md`](optional/media_gra
|
|||
### Configuring PostgreSQL
|
||||
#### (Optional) Installing RUM indexes
|
||||
|
||||
!!! Warning
|
||||
!!! warning
|
||||
It is recommended to use PostgreSQL v11 or newer. We have seen some minor issues with lower PostgreSQL versions.
|
||||
|
||||
RUM indexes are an alternative indexing scheme that is not included in PostgreSQL by default. You can read more about them on the [Configuration page](../configuration/cheatsheet.md#rum-indexing-for-full-text-search). They are completely optional and most of the time are not worth it, especially if you are running a single user instance (unless you absolutely need ordered search results).
|
||||
|
|
|
@ -10,7 +10,8 @@ However, you may compile your own OTP release from scratch. This is particularly
|
|||
|
||||
In order to compile a RedHat-compatible OTP release, you will need to run a Red Hat Linux distribution. This guide will assume you run Fedora 36, though it should also work on older Fedora releases and other Red Hat distributions. It also assumes that you have administrative rights and sufficient knowledge on how to perform common CLI tasks in Linux. If you want to run this guide with root, ignore the `sudo` at the beginning of the lines.
|
||||
|
||||
Important: keep in mind that you must build your OTP release for the specific Red Hat distribution you wish to use it on. A build on Fedora will only be compatible with a specific Fedora release version.
|
||||
!!! important
|
||||
Keep in mind that you must build your OTP release for the specific Red Hat distribution you wish to use it on. A build on Fedora will only be compatible with a specific Fedora release version.
|
||||
|
||||
## Building an OTP release for Fedora 36
|
||||
|
||||
|
|
Loading…
Reference in New Issue