Add installation note about flavour, support special cases (#222)
[akkoma] / docs / docs / installation / otp_en.md
index e746bbac48eead048f350c567ca0dd08eb5a702c..3e00d3262e78af0edfa0dc9f47bae587955cf119 100644 (file)
@@ -15,12 +15,19 @@ While in theory OTP releases are possbile to install on any compatible machine,
 
 ### Detecting flavour
 
-Paste the following into the shell:
-```sh
-arch="$(uname -m)";if [ "$arch" = "x86_64" ];then arch="amd64";elif [ "$arch" = "armv7l" ];then arch="arm";elif [ "$arch" = "aarch64" ];then arch="arm64";else echo "Unsupported arch: $arch">&2;fi;if getconf GNU_LIBC_VERSION>/dev/null;then libc_postfix="";elif [ "$(ldd 2>&1|head -c 9)" = "musl libc" ];then libc_postfix="-musl";elif [ "$(find /lib/libc.musl*|wc -l)" ];then libc_postfix="-musl";else echo "Unsupported libc">&2;fi;echo "$arch$libc_postfix"
-```
+This is a little more complex than it used to be (thanks ubuntu)
+
+Use the following mapping to figure out your flavour:
 
-If your platform is supported the output will contain the flavour string, you will need it later. If not, this just means that we don't build releases for your platform, you can still try installing from source.
+| distribution  | flavour            | available branches  |
+| ------------- | ------------------ | ------------------- |
+| debian stable | amd64              | develop, stable     |
+| ubuntu focal  | amd64              | develop, stable     |
+| ubuntu jammy  | amd64-ubuntu-jammy | develop, stable     |
+| alpine        | amd64-musl         | stable              |
+
+Other similar distributions will _probably_ work, but if it is not listed above, there is no official
+support.
 
 ### Installing the required packages
 
@@ -299,6 +306,8 @@ su akkoma -s $SHELL -lc "./bin/pleroma_ctl user new joeuser joeuser@sld.tld --ad
 ```
 This will create an account withe the username of 'joeuser' with the email address of joeuser@sld.tld, and set that user's account as an admin. This will result in a link that you can paste into the browser, which logs you in and enables you to set the password.
 
+{! installation/frontends.include !}
+
 ## Further reading
 
 {! installation/further_reading.include !}