First
[anni] / docs / installation / openbsd_fi.md
1 # Pleroman asennus OpenBSD:llä
2
3 Tarvitset:
4 * Oman domainin
5 * OpenBSD 6.3 -serverin
6 * Auttavan ymmärryksen unix-järjestelmistä
7
8 Komennot, joiden edessä on '#', tulee ajaa käyttäjänä `root`. Tämä on
9 suositeltavaa tehdä komennon `doas` avulla, katso `doas (1)` ja `doas.conf (5)`.
10 Tästä eteenpäin oletuksena on, että domain "esimerkki.com" osoittaa
11 serverin IP-osoitteeseen.
12
13 Jos asennuksen kanssa on ongelmia, IRC-kanava #pleroma Libera.chat tai
14 Matrix-kanava #pleroma:libera.chat ovat hyviä paikkoja löytää apua
15 (englanniksi), `/msg eal kukkuu` jos haluat välttämättä puhua härmää.
16
17 Asenna tarvittava ohjelmisto:
18
19 `# pkg_add git elixir gmake postgresql-server-10.3 postgresql-contrib-10.3 cmake ffmpeg ImageMagick`
20
21 #### Optional software
22
23 [`docs/installation/optional/media_graphics_packages.md`](../installation/optional/media_graphics_packages.md):
24   * ImageMagick
25   * ffmpeg
26   * exiftool
27
28 Asenna tarvittava ohjelmisto:
29
30 `# pkg_add ImageMagick ffmpeg p5-Image-ExifTool`
31
32 Luo postgresql-tietokanta:
33
34 `# su - _postgresql`
35
36 `$ mkdir /var/postgresql/data`
37
38 `$ initdb -D /var/postgresql/data -E UTF8`
39
40 `$ createdb`
41
42 Käynnistä tietokanta ja aseta se käynnistymään automaattisesti.
43
44 `# rcctl start postgresql`
45
46 `# rcctl enable postgresql`
47
48 Luo käyttäjä pleromaa varten (kysyy muutaman kysymyksen):
49
50 `# adduser pleroma`
51
52 Vaihda pleroma-käyttäjään ja mene kotihakemistoosi:
53
54 `# su - pleroma`
55
56 Lataa pleroman lähdekoodi:
57
58 `$ git clone -b stable https://git.pleroma.social/pleroma/pleroma.git`
59
60 `$ cd pleroma`
61
62 Asenna tarvittavat elixir-kirjastot:
63
64 `$ mix deps.get`
65
66 `$ mix deps.compile`
67
68 Luo tarvittava konfiguraatio:
69
70 `$ mix generate_config`
71
72 `$ cp config/generated_config.exs config/prod.secret.exs`
73
74 Aja luodut tietokantakomennot:
75
76 `# su _postgres -c 'psql -f config/setup_db.psql'`
77
78 `$ MIX_ENV=prod mix ecto.migrate`
79
80 Käynnistä pleroma-prosessi:
81
82 `$ MIX_ENV=prod mix compile`
83
84 `$ MIX_ENV=prod mix phx.server`
85
86 Tässä vaiheessa on hyvä tarkistaa että asetukset ovat oikein. Avaa selaimella,
87 curlilla tai vastaavalla työkalulla `esimerkki.com:4000/api/v1/instance` ja katso
88 että kohta "uri" on "https://esimerkki.com".
89
90 Huom! Muista varmistaa että muuttuja MIX_ENV on "prod" mix-komentoja ajaessasi.
91 Mix lukee oikean konfiguraatiotiedoston sen mukaisesti.
92
93 Ohessa enimmäkseen toimivaksi todettu rc.d-skripti pleroman käynnistämiseen.
94 Kirjoita se tiedostoon /etc/rc.d/pleroma. Tämän jälkeen aja
95 `# chmod +x /etc/rc.d/pleroma`, ja voit käynnistää pleroman komennolla
96 `# /etc/rc.d/pleroma start`.
97
98 ```
99 #!/bin/ksh
100 #/etc/rc.d/pleroma
101
102 daemon="cd /home/pleroma/pleroma;MIX_ENV=prod /usr/local/bin/elixir"
103 daemon_flags="--detached /usr/local/bin/mix phx.server"
104 daemon_user="pleroma"
105 rc_reload="NO"
106 rc_bg="YES"
107
108 pexp="beam"
109
110 . /etc/rc.d/rc.subr
111
112 rc_cmd $1
113 ```
114
115 Tämän jälkeen tarvitset enää HTTP-serverin välittämään kutsut pleroma-prosessille.
116 Tiedostosta `install/pleroma.nginx` löytyy esimerkkikonfiguraatio, ja TLS-sertifikaatit
117 saat ilmaiseksi esimerkiksi [letsencryptiltä](https://certbot.eff.org/lets-encrypt/opbsd-nginx.html).
118 Nginx asentuu yksinkertaisesti komennolla `# pkg_add nginx`.
119
120 Kun olet valmis, avaa https://esimerkki.com selaimessasi. Luo käyttäjä ja seuraa kiinnostavia
121 tyyppejä muilla palvelimilla!