> For the complete documentation index, see [llms.txt](https://tweak5m.gitbook.io/tweak5m-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tweak5m.gitbook.io/tweak5m-docs/installation.md).

# Installation basics

![Tweak5M — built as a developer, tested as a player](https://2540116750-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQVwHCxHPHIU6umfoUTsE%2Fuploads%2F5EZ8FGKSe7Z27SniOdtx%2Ftweak5m-banner.png?alt=media)

**From download to first start.** Follow the product-specific guide below; its requirements take priority over this general overview.

| Step     | What you do                                                           |
| -------- | --------------------------------------------------------------------- |
| Download | Sign into the purchasing Cfx.re account and get the complete resource |
| Prepare  | Back up your current files and relevant database                      |
| Install  | Follow the product's dependencies, SQL, items and icons               |
| Start    | Add the documented startup order and test during maintenance          |
| Get help | Send a redacted first error in the appropriate private support ticket |

## Choose your installation guide

* [NOIR Backpacks](/tweak5m-docs/noir-backpacks/installation.md)
* [NOIR Purses](/tweak5m-docs/noir-purses/installation.md)
* [NOIR Pouches](/tweak5m-docs/noir-pouches/installation.md)
* [NOIR Chest Bags](/tweak5m-docs/noir-chestbags/installation.md)
* [NOIR Collection](/tweak5m-docs/noir-collection/installation.md)
* [Tweak5M Library](/tweak5m-docs/tweak5m-library/installation.md)

## General installation steps

Use the copy button on Lua, SQL and configuration blocks. Read the destination above each block before pasting: an item-table fragment goes inside items.lua, SQL goes into your database tool, and ensure lines go into server.cfg. These blocks are not interchangeable.

1. Download the resource through the delivery method supplied with your order or free release.
2. Extract the archive. Find the actual resource folder containing `fxmanifest.lua`; avoid an extra nested folder.
3. Keep the supplied resource folder name unless the product guide explicitly allows renaming.
4. Place it in your server’s resources directory.
5. Install and start the dependencies listed in the product guide, in the stated order.
6. Review the configuration before starting the resource.
7. Complete only the item, database, or asset steps required by that product.
8. Start the resource in your test environment and check the server console and client console for errors.
9. Test the documented features before bringing the change to your live server.

Use exact filename case, especially on Linux. Keep a single active copy of the resource.

## If installation fails

Record the first relevant error and the action that triggered it. Repeatedly restarting without addressing the error can hide the original cause.

[Check troubleshooting](/tweak5m-docs/troubleshooting.md) or [open a support ticket](/tweak5m-docs/support.md).