> For the complete documentation index, see [llms.txt](https://documentation.rcore.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.rcore.cz/paid-resources/rcore_housing/how-to-update.md).

# How to Update

Use this guide when updating `rcore_housing` to a newer version.

{% stepper %}
{% step %}

### Make a backup

Back up the `[housing]` folder from your `resources` directory - it contains both `rcore_housing` and `rcore_housing_assets`.

Also back up your database before updating.
{% endstep %}

{% step %}

### Download the latest version

Download the latest `[housing]` package from the [CFX Portal](https://portal.cfx.re/assets/granted-assets).
{% endstep %}

{% step %}

### Replace resource files

Replace the old `[housing]` folder with the new one.

Keep your custom `config.lua`, `sconfig.lua`, and `configs/*.lua` files only after merging them against the new defaults - new options are added between releases.
{% endstep %}

{% step %}

### Review configuration changes

Compare your old `config.lua` and `configs/*.lua` files with the new versions. Add any new options that were introduced in the update.

Most properties, interiors, furniture, listings, upgrades, and permissions are stored in the database and managed from `/housing` and `/realestate` - they survive updates unchanged.
{% endstep %}
{% endstepper %}