Dokumen ini diterjemahkan oleh komunitas. Kamu dapat ikut berkontribusi menyempurnakan terjemahan ini melalui Crowdin. Kami sangat mengapresiasi atas kerjasama yang telah kamu berikan dengan ikut berkontribusi dalam proyek ini 🙏.
Panduan Pemasangan dan Penyetelan Misskey
Panduan ini akan menjelaskan bagaimana cara memasang dan menyetel peladen Misskey.
Jangan pernah mengubah nama domain (hostname) peladen ketika kamu sudah mulai menggunakannya!
Mohon pasang dan setel aplikasi berikut:
- Node.js (versi 20.4.x atau di atasnya)
- PostgreSQL (versi 15 atau di atasnya)
- Redis
- FFmpeg
Jika kamu menggunakan Debian/Ubuntu, kamu harus memasang paket build-essential
.
corepack
harus dinyalakan
sudo corepack enable
Buat pengguna
Menjalankan Misskey sebagai root bukanlah ide yang bagus. Oleh karena itu, kita akan membuat pengguna baru untuk menangani masalah tersebut. Sebagai contoh dalam distribusi Debian:
adduser --disabled-password --disabled-login misskey
Pasang 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
Atur
Salin berkas .config/example.yml
dan ubah namanya ke default.yml
.
cp .config/example.yml .config/default.yml
Sunting default.yml
.
Bangun dan inisialisasi
Perintah berikut akan membangun Misskey dan menginisialisasi basis data. Proses ini akan memakan waktu sesaat.
NODE_ENV=production pnpm run build
pnpm run init
Jalankan
Selamat! Kamu sudah dapat memulai peladen Misskey dengan perintah berikut.
NODE_ENV=production pnpm run start
GLHF✨
Menjalankan dengan systemd
Buat berkas layanan systemd di sini
/etc/systemd/system/misskey.service
Sunting, tempelkan konfigurasi berikut dan simpan:
[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
Apabila kamu ingin menggunakan Misskey dengan port di bawah 1024 pada sistem operasi CentOS, kamu perlu mengubah ExecStart=/usr/bin/sudo /usr/bin/npm start
.
Nyalakan ulang systemd dan nyalakan layanan misskey.
sudo systemctl daemon-reload
sudo systemctl enable misskey
Jalankan layanan misskey.
sudo systemctl start misskey
Kamu dapat mengecek apakah layanannya berjalan dengan memasukkan perintah systemctl status misskey
.
Panduan memutakhirkan peladen Misskey ke versi terbaru
Ketika memutakhirkan, pastikan mengecek catatan rilisan untuk mengetahui lebih awal akan perubahan ataupun tambahan pekerjaan yang nantinya dibutuhkan (biasanya tidak perlu).
Lakukan pull
pada branch master
, pasang, bangun dan migrasi basis data:
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
Perintah tersebut akan memakan waktu sesaat bergantung dengan konten dari pemutakhiran dan ukuran basis data.
Setelah pemutakhiran selesai, mulai ulang proses Misskey.
sudo systemctl restart misskey
Apabila kamu menemukan masalah pada saat memutakhirkan, coba jalankan perintah berikut:
pnpm run clean
ataupnpm run clean-all
pnpm rebuild
:::