mirror of
https://iceshrimp.dev/Crimekillz/jointrashposs.git
synced 2024-11-24 09:49:06 +01:00
226 lines
5.0 KiB
Markdown
226 lines
5.0 KiB
Markdown
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](https://nodejs.org/en/)** (20.4.x)
|
|
* **[PostgreSQL](https://www.postgresql.org/)** (15.x)
|
|
* **[Redis](https://redis.io/)**
|
|
* **[FFmpeg](https://www.ffmpeg.org/)**
|
|
|
|
Jeżeli używasz Debian/Ubuntu, powinieneś zainstalować pakiet `build-essential`.
|
|
|
|
corepack musi być włączony.
|
|
|
|
```sh
|
|
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:
|
|
|
|
```sh
|
|
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](https://github.com/misskey-dev/misskey/releases/latest)
|
|
|
|
`git checkout master`
|
|
|
|
5. Pobierz submoduły
|
|
|
|
`git submodule update --init`
|
|
|
|
5. 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
|
|
|
|
```sh
|
|
#!/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`)
|