diff --git a/6.x/faq.md b/6.x/faq.md index d484d987..bcd9c0a9 100644 --- a/6.x/faq.md +++ b/6.x/faq.md @@ -41,8 +41,8 @@ Backpack PRO is a closed-source add-on, which requires payment in order to recei No - we're no longer giving away free licenses. But we _have_ released Backpack CRUD v5 and v6 under MIT License, which means it's free & open-source. It has fewer features, but you can do absolutely anything you want with it. - -## Miscellaneous + +## Installation @@ -96,3 +96,25 @@ composer remove backpack/crud ``` That's it! If you've decided NOT to use Backpack, we'd be super-grateful if you could send us an email telling us WHY you didn't like Backpack, or it didn't fit your project. It might help us take Backpack in a different direction, one where you might want to use it. Thank you 🙏 + + + +### Errors when installing paid add-ons + +When installing our [paid add-ons](https://backpackforlaravel.com/addons): +- Composer will add our private repository (`repo.backpackforlaravel.com`) to your `composer.json` file; +- Composer will try to download the package the `dist` version of the package from there; + - if successful, you're good; + - if the `dist` version fails to download, Composer will throw an error (with an HTTPS code like 402); then Composer will try to download the `source` version of the package straight from our Github repo; that will 100% fail, because you do NOT have access to our private Github repo; to rephrase, you don't have access to the `source`, only to `dist`; + +Unfortunately we cannot customize the errors that Composer throws, so the error text might be confusing. Please take a look at the HTTP error code shown in the error to understand what happened: +- 400 Error - Bad Request - user & password do not match; please check your auth credentials; +- 401 Error - Unauthorized - no token username or password; please check your auth credentials; +- 402 Error - Payment Required - you are trying to download a version newer than you have access; our system will send you an email with clear instructions on what to do to require the latest version you have access to; you can also check the latest version you have access to in your Backpack account, and require that version specifically; alternatively, please purchase the same product again, to gain access to more updates, then it will work again; +- 404 Error - Not Found - the package you are trying to download that does not exist; +- 429 Error - Too Many Requests - our server has received too many requests from your IP; please wait 1 min and try again; + +If you still can't figure it out, please [open a new discussion in our Community Forum](https://github.com/Laravel-Backpack/community-forum/discussions/categories/q-a-help). Please make sure to: +- mention the steps you have followed to get there (eg. `composer require backpack/pro`, `php artisan backpack:require:pro` etc); +- include a screenshot of the console output, so we understand what happened; +- cross out any personal data (eg. token username or password);