3.3 KiB
| description |
|---|
| Questa guida spiega come installare e configurare Misskey |
Guida alla costruzione di Misskey
Questa guida spiega come installare e configurare Misskey
::: danger Never change the domain name (hostname) of an instance once you start using it! :::
::: tip Occorre installare il seguente software
- Node.js (20.4 o successivo)
- PostgreSQL (15 o successivo)
- Redis
- FFmpeg
Debian/Ubuntuをお使いであれば、build-essentialパッケージをインストールしておくと良いです。
corepackが有効化されていること
sudo corepack enable
:::
Creazione utente
Misskey non va eseguito tramite l'utente amministratore root. Occorre creare un utente ad-hoc, esempio per Debian/Ubuntu:
adduser --disabled-password --disabled-login misskey
Installazione Misskey
sudo -iu misskey
git clone --recursive https://github.com/misskey-dev/misskey.git
cd misskey
git checkout master
git submodule update --init
NODE_ENV=production pnpm install --frozen-lockfile
Variabili d'ambiente
Copia il file .config/example.yml in un file chiamato default.yml
cp .config/example.yml .config/default.yml
Modifica default.yml seguendo le indicazioni nel file.
Costruzione e inizializzazione
Avvia la build e inizializza il DB, potrebbe richiedere un po' di tempo.
NODE_ENV=production pnpm run build
pnpm run init
::: tip
Chi usa Debian/Ubuntu ha bisogno del pacchetto build-essential
:::
Avviamento
Al termine avvia Misskey usando:
NODE_ENV=production pnpm run start
:::: Configurazione di systemd
Crea il file /etc/systemd/system/misskey.service
Incollaci questa configurazione:
[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
::: warning
Se usi Misskey su CentOS e una porta inferiore a 1024, Devi configurare ExecStart=/usr/bin/sudo /usr/bin/npm start
:::
Ricarica systemd, abilita e avvia il servizio
sudo systemctl daemon-reload
sudo systemctl enable misskey
sudo systemctl start misskey
::: tip
Per controllare lo stato del servizio: systemctl status misskey
:::
::::
Aggiornamento di Misskey
::: warning Leggi sempre le Note di rilascio per sapere se ci siano attività aggiuntive da svolgere. :::
Ottieni il codice sorgente dal branch master e le migrazioni del database:
git checkout master
git pull
git submodule update --init
NODE_ENV=production pnpm install --frozen-lockfile
NODE_ENV=production pnpm run build
pnpm run migrate
A seconda della grandezza del database e dal contenuto degli aggiornamenti, potrebbe impiegarci più o meno tempo.
Riavvia il servizio Misskey al termine dell'aggiornamento.
sudo systemctl restart misskey
::: tip Se ricevi errori in fase di compilazione, prova i seguenti comandi:
pnpm run cleanまたはpnpm run clean-allpnpm rebuild
:::