akkoma/docs/installation/openbsd_fi.md
norm 3ad3a114de Update install docs (#38)
Reviewed-on: https://akkoma.dev/AkkomaGang/akkoma/pulls/38
Co-authored-by: norm <normandy@biribiri.dev>
Co-committed-by: norm <normandy@biribiri.dev>
2022-07-02 21:00:01 +00:00

3.2 KiB

Akkoman asennus OpenBSD:llä

Tarvitset:

  • Oman domainin
  • OpenBSD 6.3 -serverin
  • Auttavan ymmärryksen unix-järjestelmistä

Komennot, joiden edessä on '#', tulee ajaa käyttäjänä root. Tämä on suositeltavaa tehdä komennon doas avulla, katso doas (1) ja doas.conf (5). Tästä eteenpäin oletuksena on, että domain "esimerkki.com" osoittaa serverin IP-osoitteeseen.

Jos asennuksen kanssa on ongelmia, IRC-kanava #pleroma Libera.chat tai Matrix-kanava #pleroma:libera.chat ovat hyviä paikkoja löytää apua (englanniksi), /msg eal kukkuu jos haluat välttämättä puhua härmää.

Asenna tarvittava ohjelmisto:

# pkg_add git elixir gmake postgresql-server-10.3 postgresql-contrib-10.3 cmake ffmpeg ImageMagick

Optional software

docs/installation/optional/media_graphics_packages.md:

  • ImageMagick
  • ffmpeg
  • exiftool

Asenna tarvittava ohjelmisto:

# pkg_add ImageMagick ffmpeg p5-Image-ExifTool

Luo postgresql-tietokanta:

# su - _postgresql

$ mkdir /var/postgresql/data

$ initdb -D /var/postgresql/data -E UTF8

$ createdb

Käynnistä tietokanta ja aseta se käynnistymään automaattisesti.

# rcctl start postgresql

# rcctl enable postgresql

Luo käyttäjä akkomaa varten (kysyy muutaman kysymyksen):

# adduser akkoma

Vaihda akkoma-käyttäjään ja mene kotihakemistoosi:

# su - akkoma

Lataa akkoman lähdekoodi:

$ git clone https://akkoma.dev/AkkomaGang/akkoma.git

$ cd akkoma

Asenna tarvittavat elixir-kirjastot:

$ mix deps.get

$ mix deps.compile

Luo tarvittava konfiguraatio:

$ mix generate_config

$ cp config/generated_config.exs config/prod.secret.exs

Aja luodut tietokantakomennot:

# su _postgres -c 'psql -f config/setup_db.psql'

$ MIX_ENV=prod mix ecto.migrate

Käynnistä akkoma-prosessi:

$ MIX_ENV=prod mix compile

$ MIX_ENV=prod mix phx.server

Tässä vaiheessa on hyvä tarkistaa että asetukset ovat oikein. Avaa selaimella, curlilla tai vastaavalla työkalulla esimerkki.com:4000/api/v1/instance ja katso että kohta "uri" on "https://esimerkki.com".

Huom! Muista varmistaa että muuttuja MIX_ENV on "prod" mix-komentoja ajaessasi. Mix lukee oikean konfiguraatiotiedoston sen mukaisesti.

Ohessa enimmäkseen toimivaksi todettu rc.d-skripti akkoman käynnistämiseen. Kirjoita se tiedostoon /etc/rc.d/akkoma. Tämän jälkeen aja # chmod +x /etc/rc.d/akkoma, ja voit käynnistää akkoman komennolla # /etc/rc.d/akkoma start.

#!/bin/ksh
#/etc/rc.d/akkoma

daemon="cd /home/akkoma/akkoma;MIX_ENV=prod /usr/local/bin/elixir"
daemon_flags="--detached /usr/local/bin/mix phx.server"
daemon_user="akkoma"
rc_reload="NO"
rc_bg="YES"

pexp="beam"

. /etc/rc.d/rc.subr

rc_cmd $1

Tämän jälkeen tarvitset enää HTTP-serverin välittämään kutsut akkoma-prosessille. Tiedostosta install/akkoma.nginx löytyy esimerkkikonfiguraatio, ja TLS-sertifikaatit saat ilmaiseksi esimerkiksi letsencryptiltä. Nginx asentuu yksinkertaisesti komennolla # pkg_add nginx.

Kun olet valmis, avaa https://esimerkki.com selaimessasi. Luo käyttäjä ja seuraa kiinnostavia tyyppejä muilla palvelimilla!