# How to update

This guide shows you how to update without losing your custom items, settings, and configurations

{% hint style="danger" %}
**Always backup before updating!** You'll lose all your customizations if you skip this step
{% endhint %}

## What to Backup

**Always backup these folders:**

* `_backups/` - Items list backup
* `_data/` - Your items and settings
* `_hooks/` - Crafting recipes and custom logic
* `_images/` - Items images
* `_modules` - Integration with external scripts
* `integrations/` - Some settings
* `current_config.json` - Settings file

**Only if you modified them:**

* `_images/` - Custom item images
* `dist/assets/variables.css` - Custom theme colors
* `_locales/` - Translations
* `dist/menu_translations/` - Menu translations

## Update Steps

1. **Stop your server**
2. **Backup your files**
   * Copy the folders to backup from the server to a safe location (like your Desktop)
3. **Remove the old inventory from server**
   * Remove the entire `jaksam_inventory` folder from your server
4. **Install the new version**
   * Download the latest version
   * Extract and copy the new `jaksam_inventory` folder to your server
5. **Restore your backups**
   * Copy your backup folders back into the new `jaksam_inventory` folder:
     * Replace `_data/` with your backup `_data/`
     * Replace `_hooks/` with your backup `_hooks/`
     * Replace `integrations/` with your backup `integrations/`
     * Replace `_images/` with your backup `_images/`
     * Replace `dist/menu_translations/` with your backup `dist/menu_translations/`
     * Replace `current_config.json` with your backup `current_config.json`
     * Replace `dist/assets/variables.css` with your backup `dist/assets/variables.css`
6. **Start your server and test**

## Quick Reference

| Folder/File                 | When to backup                                |
| --------------------------- | --------------------------------------------- |
| `_data/`                    | ✅ Always                                      |
| `_backups/`                 | ✅ Always                                      |
| `_hooks/`                   | ✅ Always                                      |
| `_modules_/`                | ✅ Always                                      |
| `integrations/`             | ✅ Always                                      |
| `current_config.json`       | ✅ Always                                      |
| `dist/assets/variables.css` | Only if you customized default theme globally |
| `_images/`                  | Only if you added custom images               |
| `_locales/`                 | Only if you added custom translations         |
| `dist/menu_translations/`   | Only if you added custom menu translations    |

## Troubleshooting

**Items disappeared?**

* Restore the `_data/` folder from your backup

**Crafting recipes missing?**

* Restore the `_hooks/` folder from your backup

**Settings reset?**

* Restore the `current_config.json` file from your backup

**Theme colors reset?**

* Restore `dist/assets/variables.css` from your backup

**Server won't start?**

* Wait 30 seconds (database is updating automatically)
* If still broken, restore your entire backup and contact support

{% hint style="info" %}
Keep your backup folder for a few days after updating, just in case
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.jaksam-scripts.com/jaksam-inventory/how-to-update.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.