Merge branch 'develop' into feature/digest-email
[akkoma] / 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 Freenodessa tai
14 Matrix-kanava #freenode_#pleroma:matrix.org 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`
20
21 Luo postgresql-tietokanta:
22
23 `# su - _postgresql`
24
25 `$ mkdir /var/postgresql/data`
26
27 `$ initdb -D /var/postgresql/data -E UTF8`
28
29 `$ createdb`
30
31 Käynnistä tietokanta ja aseta se käynnistymään automaattisesti.
32
33 `# rcctl start postgresql`
34
35 `# rcctl enable postgresql`
36
37 Luo käyttäjä pleromaa varten (kysyy muutaman kysymyksen):
38
39 `# adduser pleroma`
40
41 Vaihda pleroma-käyttäjään ja mene kotihakemistoosi:
42
43 `# su - pleroma`
44
45 Lataa pleroman lähdekoodi:
46
47 `$ git clone -b master https://git.pleroma.social/pleroma/pleroma.git`
48
49 `$ cd pleroma`
50
51 Asenna tarvittavat elixir-kirjastot:
52
53 `$ mix deps.get`
54
55 `$ mix deps.compile`
56
57 Luo tarvittava konfiguraatio:
58
59 `$ mix generate_config`
60
61 `$ cp config/generated_config.exs config/prod.secret.exs`
62
63 Aja luodut tietokantakomennot:
64
65 `# su _postgres -c 'psql -f config/setup_db.psql'`
66
67 `$ MIX_ENV=prod mix ecto.migrate`
68
69 Käynnistä pleroma-prosessi:
70
71 `$ MIX_ENV=prod mix compile`
72
73 `$ MIX_ENV=prod mix phx.server`
74
75 Tässä vaiheessa on hyvä tarkistaa että asetukset ovat oikein. Avaa selaimella,
76 curlilla tai vastaavalla työkalulla `esimerkki.com:4000/api/v1/instance` ja katso
77 että kohta "uri" on "https://esimerkki.com".
78
79 Huom! Muista varmistaa että muuttuja MIX_ENV on "prod" mix-komentoja ajaessasi.
80 Mix lukee oikean konfiguraatiotiedoston sen mukaisesti.
81
82 Ohessa enimmäkseen toimivaksi todettu rc.d-skripti pleroman käynnistämiseen.
83 Kirjoita se tiedostoon /etc/rc.d/pleroma. Tämän jälkeen aja
84 `# chmod +x /etc/rc.d/pleroma`, ja voit käynnistää pleroman komennolla
85 `# /etc/rc.d/pleroma start`.
86
87 ```
88 #!/bin/ksh
89 #/etc/rc.d/pleroma
90
91 daemon="cd /home/pleroma/pleroma;MIX_ENV=prod /usr/local/bin/elixir"
92 daemon_flags="--detached /usr/local/bin/mix phx.server"
93 daemon_user="pleroma"
94 rc_reload="NO"
95 rc_bg="YES"
96
97 pexp="beam"
98
99 . /etc/rc.d/rc.subr
100
101 rc_cmd $1
102 ```
103
104 Tämän jälkeen tarvitset enää HTTP-serverin välittämään kutsut pleroma-prosessille.
105 Tiedostosta `install/pleroma.nginx` löytyy esimerkkikonfiguraatio, ja TLS-sertifikaatit
106 saat ilmaiseksi esimerkiksi [letsencryptiltä](https://certbot.eff.org/lets-encrypt/opbsd-nginx.html).
107 Nginx asentuu yksinkertaisesti komennolla `# pkg_add nginx`.
108
109 Kun olet valmis, avaa https://esimerkki.com selaimessasi. Luo käyttäjä ja seuraa kiinnostavia
110 tyyppejä muilla palvelimilla!