koel/docs/plus/purchase-activation.md

# Purchase & Activation

## Pricing

Koel Plus employs a super simple pricing model: a __one-time__ payment of {{ config.plus.price }}.
You read that right: no subscription, no recurring payments, no hidden fees, no per- or additional-seat costs — I hate those bullshit as much as you do.
Pay __once__, and you get all current _and_ future updates at no extra fee, forever.

## Purchase

<a class="lemonsqueezy-button" :href="config.plus.purchaseUrl">Click here</a> to purchase Koel Plus.

<div class="info custom-block" style="padding-top: 8px">
❤️  If you’re a current or past sponsor, <a href="mailto:me@phanan.net">reach out</a> for a discount code. ❤️
</div>

## Activation

<UISubjectToChangeNote />

After purchasing, you'll receive an email with a license key. To activate Koel Plus, you can use either the web interface or the command line.

### Via the Web Interface

1. Log into your Koel installation as an admin and locate the "Upgrade to Plus" button in the bottom-left corner of the screen.
  <img src="../assets/img/plus/upgrade-button.webp" class="rounded-md" style="height: 36px" alt="Upgrade to Plus button" />
2. Click the button to bring up the "Koel Plus" dialog:
  <img loading="lazy" src="../assets/img/plus/dialog.webp" class="border-0" style="max-height: 344px" alt="Koel Plus dialog" />
3. Click "I have a license key," enter your key in the input field, and click "Activate."
  <img loading="lazy" src="../assets/img/plus/dialog-key.webp" class="border-0" style="max-height: 344px" alt="Koel Plus dialog - Enter key" />
4. If the key is valid, Koel will display a Success message and reload itself.

### Via the Command Line

From the root of your Koel installation, run:

```bash
php artisan koel:license:activate YOUR_LICENSE_KEY
```

If the key is valid, you'll see a Success message.

### Verification

To verify that Koel Plus is activated, reload the web app if you haven't done so.
Afterward, trigger the About Koel modal by clicking the <InterfaceIcon :src="iconInfo" /> icon in the bottom-right corner of the screen.
You should see the information about your Koel Plus license in the modal.

<img loading="lazy" src="../assets/img/plus/about-plus.webp" style="max-width: 480px" alt="About modal with Plus">

## Deactivation

If for any reason you need to deactivate Koel Plus, you can do so via the command line:

```bash
php artisan koel:license:deactivate
```

Reload Koel, and it will revert to the Community edition. You can re-activate it at any time following the steps above.

<script lang="ts" setup>
import { onMounted } from 'vue'
import iconInfo from '../assets/icons/info.svg'
import config from '../config'

onMounted(() => {
  window.createLemonSqueezy()
})
</script>

<style lang="scss" module>
ol img {
  margin: 1.2rem 0;
}
</style>