---
title: 'Menginstal dan meningkatkan plugin'
description: 'Mulai cepat NocoBase: menginstal dan meningkatkan plugin'
keywords: 'install,upgrade,plugins,NocoBase'
---

# Menginstal dan meningkatkan plugin

## Plugin bawaan

Plugin bawaan NocoBase akan diperbarui secara otomatis mengikuti versi inti, tanpa perlu tindakan manual.

## Plugin komersial

Untuk metode aktivasi dan peningkatan yang lebih rinci, silakan lihat: [Aktivasi dan peningkatan plugin komersial](../api/cli/license/index.md)

## Plugin pihak ketiga

### Menginstal plugin melalui baris perintah

```bash
yarn pm pull https://github.com/nocobase/plugin-auth-cas/releases/download/v1.4.0/plugin-auth-cas-1.4.0.tgz
yarn pm pull /your/path/plugin-auth-cas-1.4.0.tgz
```

Jika aplikasi sudah menginstal plugin ini dan perlu ditingkatkan, jalankan:

```bash
yarn nocobase upgrade --skip-code-update
```

### Unggah dan ekstrak secara manual

Silakan unduh paket plugin ke lokal terlebih dahulu, lalu unggah dan ekstrak secara manual ke direktori `./storage/plugins`. Jika plugin ini sudah diaktifkan, jalankan perintah berikut setelah unggah dan ekstraksi selesai untuk menyelesaikan peningkatan plugin.

> ⚠️ **Catatan**: Untuk menghindari masalah cache, pastikan aplikasi NocoBase sudah dihentikan sebelum menjalankan.

```bash
yarn nocobase upgrade --skip-code-update
```

### Cara yang benar untuk mengekstrak plugin

Contoh berikut menunjukkan cara mengekstrak paket plugin dengan benar ke direktori yang ditentukan:

```bash
mkdir -p /my-nocobase/storage/plugins/@nocobase/plugin-auth-cas && \
  tar -xvzf /downloads/plugin-auth-cas-1.4.0.tgz \
  -C /my-nocobase/storage/plugins/@nocobase/plugin-auth-cas \
  --strip-components=1
```

Perintah ini akan mengekstrak plugin ke direktori yang ditentukan tanpa membuat lapisan direktori `package` tambahan.

```bash
/my-nocobase/storage/plugins/@nocobase/plugin-auth-cas
```

### Contoh struktur direktori yang benar

```bash
./plugin-auth-cas/dist/server/migrations/20240425200816-change-locale-module.js
./plugin-auth-cas/dist/server/auth.js
./plugin-auth-cas/client.js
./plugin-auth-cas/dist/constants.js
./plugin-auth-cas/dist/externalVersion.js
./plugin-auth-cas/dist/client/index.js
./plugin-auth-cas/dist/index.js
./plugin-auth-cas/dist/server/index.js
./plugin-auth-cas/dist/server/actions/login.js
./plugin-auth-cas/dist/server/plugin.js
./plugin-auth-cas/server.js
./plugin-auth-cas/dist/server/actions/service.js
./plugin-auth-cas/dist/locale/en-US.json
./plugin-auth-cas/dist/locale/ko_KR.json
./plugin-auth-cas/package.json
./plugin-auth-cas/dist/locale/zh-CN.json
./plugin-auth-cas/README.md
./plugin-auth-cas/README.zh-CN.md
./plugin-auth-cas/dist/server/migrations/20240425200816-change-locale-module.d.ts
./plugin-auth-cas/dist/server/auth.d.ts
./plugin-auth-cas/client.d.ts
./plugin-auth-cas/dist/constants.d.ts
./plugin-auth-cas/dist/client/index.d.ts
./plugin-auth-cas/dist/client/locale/index.d.ts
./plugin-auth-cas/dist/index.d.ts
./plugin-auth-cas/dist/server/index.d.ts
./plugin-auth-cas/dist/server/actions/login.d.ts
./plugin-auth-cas/dist/client/Options.d.ts
./plugin-auth-cas/dist/server/plugin.d.ts
./plugin-auth-cas/server.d.ts
./plugin-auth-cas/dist/server/actions/service.d.ts
./plugin-auth-cas/dist/client/SigninPage.d.ts
./plugin-auth-cas/LICENSE.txt
```
