wehub-resource-sync
107 lines
2.5 KiB
Markdown
107 lines
2.5 KiB
Markdown
---
|
|
sidebar_position: 1
|
|
_i18n_hash: bd680ba831a70a5f00ce7db124d136dc
|
|
---
|
|
# Instalasi tanpa Docker
|
|
|
|
Menggunakan Docker untuk menginstal `Tianji` adalah cara terbaik karena Anda tidak perlu mempertimbangkan masalah lingkungan.
|
|
|
|
Namun, jika server Anda tidak mendukung Docker, Anda dapat mencoba menginstalnya secara manual.
|
|
|
|
## Persyaratan
|
|
|
|
Anda membutuhkan:
|
|
|
|
- [Node.js](https://nodejs.org/en/download/) 18.12+ / 20.4+
|
|
- [pnpm](https://pnpm.io/) 9.x (lebih baik 9.7.1)
|
|
- [Git](https://git-scm.com/downloads)
|
|
- [postgresql](https://www.postgresql.org/)
|
|
- [pm2](https://pm2.keymetrics.io/) - Untuk menjalankan Tianji di latar belakang
|
|
- [apprise](https://github.com/caronc/apprise) - opsional, jika Anda membutuhkannya untuk pemberitahuan
|
|
|
|
## Kloning Kode dan Bangun
|
|
|
|
```bash
|
|
git clone https://github.com/msgbyte/tianji.git
|
|
cd tianji
|
|
pnpm install
|
|
|
|
pnpm build
|
|
```
|
|
|
|
## Siapkan File Lingkungan
|
|
|
|
Buat file `.env` di `src/server`
|
|
|
|
```ini
|
|
DATABASE_URL="postgresql://user:pass@127.0.0.1:5432/tianji?schema=public"
|
|
JWT_SECRET="ganti-dengan-string-acak"
|
|
```
|
|
|
|
Pastikan URL database Anda benar. dan jangan lupa buat database sebelumnya.
|
|
|
|
Untuk lebih banyak pengaturan lingkungan bisa cek dokumen ini [environment](./environment.md)
|
|
|
|
> jika Anda bisa, lebih baik pastikan encoding Anda adalah en_US.utf8, misalnya: `createdb -E UTF8 -l en_US.utf8 tianji`
|
|
|
|
## Jalankan Server
|
|
|
|
```bash
|
|
npm install pm2 -g && pm2 install pm2-logrotate
|
|
|
|
# Inisialisasi migrasi db
|
|
cd src/server
|
|
pnpm db:migrate:apply
|
|
|
|
# Mulai Server
|
|
pm2 start ./dist/src/server/main.js --name tianji
|
|
```
|
|
|
|
Secara default, `Tianji` akan berjalan di `http://localhost:12345`
|
|
|
|
## Perbarui Kode ke Versi Baru
|
|
|
|
```bash
|
|
# Checkout rilis/tag baru
|
|
cd tianji
|
|
git fetch --tags
|
|
git checkout -q <version>
|
|
|
|
# Perbarui dependensi
|
|
pnpm install
|
|
|
|
# Bangun proyek
|
|
pnpm build
|
|
|
|
# Jalankan migrasi db
|
|
cd src/server
|
|
pnpm db:migrate:apply
|
|
|
|
# Restart Server
|
|
pm2 restart tianji
|
|
```
|
|
|
|
# Pertanyaan yang Sering Diajukan
|
|
|
|
## Instalasi `isolated-vm` gagal
|
|
|
|
Jika Anda menggunakan python 3.12, akan muncul kesalahan seperti ini:
|
|
|
|
```
|
|
ModuleNotFoundError: No module named 'distutils'
|
|
```
|
|
|
|
Ini karena python 3.12 menghapus `distutils` dari modul bawaan. sekarang kita memiliki solusi yang baik tentang ini.
|
|
|
|
Anda bisa mengganti versi python Anda dari 3.12 ke 3.9 untuk mengatasinya.
|
|
|
|
### Cara mengatasinya di python yang dikendalikan oleh brew
|
|
|
|
```bash
|
|
brew install python@3.9
|
|
rm /opt/homebrew/bin/python3
|
|
ln -sf /opt/homebrew/bin/python3 /opt/homebrew/bin/python3.9
|
|
```
|
|
|
|
kemudian Anda bisa mengecek versinya dengan `python3 --version`
|