jointrashposs/content/pl/.docs-legacy/install/manual.md

Poradnik instalacji i konfiguracji Misskey

Dziękujemy za zainteresowanie stworzeniem własnej instancji Misskey! Ten poradnik opisuje jak zainstalować i skonfigurować MIsskey.

---

:::danger Nigdy nie zmieniaj nazwy domeny(hostname) kiedy będziesz korzystać z instacji! :::

1. Zainstaluj dependencje

Proszę zainstalować wymagane zależności i je skonfigurować:

Dependencje :package

• Node.js (20.4.x)
• PostgreSQL (15.x)
• Redis
• FFmpeg

Jeżeli używasz Debian/Ubuntu, powinieneś zainstalować pakiet build-essential.

corepack musi być włączony.

sudo corepack enable

2. Stwórz użytkownika dla Misskey

Używanie Misskey z prawami root'a nie jest dobrym pomysłem, więc stwórz użytkownika dla tego. W debiano-podobnych systemach na przykład za pomocą tej komendy:

adduser --disabled-password --disabled-login misskey

3. Zainstaluj Misskey

1. Połącz się z użytkownikiem misskey

sudo -iu misskey

2. Sklonuj repozytorium Misskey

git clone --recursive https://github.com/misskey-dev/misskey.git

3. Przejdź do folderu z pobranym repozytorium

cd misskey

4. Sprawdź najnowsze wydanie

git checkout master

5. Pobierz submoduły

   git submodule update --init

6. Zainstaluj Misskey's dependencje

pnpm install --frozen-lockfile

4. Skonfiguruj Misskey

1. Skopiuj .config/example.yml i zmień nazwę na default.yml.

cp .config/example.yml .config/default.yml

2. Edytuj default.yml

5. Zbuduj Misskey

Zbuduj Misskey z podanymi parametrami:

NODE_ENV=production pnpm run build

Jeśli używasz Debiana to musisz mieć zainstalowane paczki build-essential, python.

6. Zainicjuj bazę danych

1. Utwórz bazę danych PostgreSQL z prawidłowymi danymi użytkownika oraz pustą bazą danych o nazwie podanej w pliku konfiguracyjnym. Upewnij się że baza danych łączy się bez problemów z użytkownikiem który będzie później uruchamiał Misskey czy nic nie powodoje problemów. Enkodowanie bazy danych powinno być ustawione na UTF8.

sudo -u postgres psql
create database misskey with encoding = 'UTF8';
create user misskey with encrypted password '{YOUR_PASSWORD}';
grant all privileges on database misskey to misskey;
\q

2. Uruchom inicjalizacje bazy danych

pnpm run init

7. Koniec

Dobra robota! Teraz masz środowisko które uruchamia Misskey.

Uruchamianie normalnie

Wystarczy NODE_ENV=production pnpm run start i GLHF!

Uruchom z SystemD

1. Utwórz usługę SystemD

/etc/systemd/system/misskey.service

2. Edytuj plik i wklej następujący kod:

:::g-details

[Unit]
Description=Misskey daemon

[Service]
Type=simple
User=misskey
ExecStart=/usr/bin/npm start
WorkingDirectory=/home/misskey/misskey
Environment="NODE_ENV=production"
TimeoutSec=60
StandardOutput=journal
StandardError=journal
SyslogIdentifier=misskey
Restart=always

[Install]
WantedBy=multi-user.target

:::

3. Odświerz systemD i aktywuj usługę Misskey.

sudo systemctl daemon-reload; sudo systemctl enable misskey

4. Uruchom usługę Misskey.

sudo systemctl start misskey

Możesz sprawdzić działanie usługi wpisując

systemctl status misskey

Uruchom z OpenRC

1. Skopiuj poniższy tekst do /etc/init.d/misskey:

:::g-details

#!/sbin/openrc-run

name=misskey
description="Misskey daemon"

command="/usr/bin/npm"
command_args="start"
command_user="misskey"

supervisor="supervise-daemon"
supervise_daemon_args=" -d /home/misskey/misskey -e NODE_ENV=\"production\""

pidfile="/run/${RC_SVCNAME}.pid"

depend() {
 need net
 use logger

 # alterbnatynie usuń komentaż jeżeli używasz nginx
 #use logger nginx
}

:::

2. Usutaw uruchomienie usługi przy starcie systemu

rc-update add misskey

3. Uruchom usługę Misskey

rc-service misskey start

Możesz sprawdzić działanie usługi z komendą

rc-service misskey status

Aktualizowanie Misskey do najnowszej wersji

1. git checkout master
2. git pull
3. git submodule update --init
4. NODE_ENV=production pnpm install --frozen-lockfile
5. NODE_ENV=production pnpm run build
6. pnpm run migrate
7. Zrestartuj proces Misskey
8. GLHF!

Jeżeli napotkasz problemy to spróbuj:

1. pnpm run clean lub pnpm run clean-all
2. Ponów aktualizację (Nie zapomnij o pnpm install)