# How to Clear FiveM Cache Safely

Clearing FiveM cache can help when downloaded server content is stale or a local cache is damaged.
It is **not** a universal fix for connection failures, server-side script errors, authentication
problems, outdated server artifacts, or a broken GTA V installation.

Do not clear cache on a schedule. Use it when the symptoms point to cached client/server content.

## Quick answer

On a normal Windows installation:

1. close FiveM,
2. press `Win + R`,
3. open `%localappdata%\FiveM\FiveM.app\data`,
4. remove the cache directory relevant to the problem:
   - `cache`
   - `server-cache`
   - `server-cache-priv`
5. start FiveM again and reconnect.

FiveM will rebuild or redownload data it needs. The first reconnect can therefore take longer.

> Do not delete unrelated FiveM application data, GTA V save/configuration folders, authentication
> files, or the whole FiveM installation just because a cache clear did not help. Preserve logs
> before troubleshooting so you still have evidence of the original error.

![Safe FiveM cache diagnosis and cleanup workflow](/diagrams/cache.svg)

*Conceptual diagram; verify the behavior against your installed resource version.*

## Before deleting anything

A cache clear is most useful when the issue appeared after server assets or resources changed.

Check these first:

- **Only one server is affected:** the problem may be server-specific. Test another known server
  before changing the client installation.
- **The server is offline or unreachable:** cache deletion does not repair routing, firewall or
  server-list configuration.
- **F8 shows a specific error:** search that error first. Cfx documents targeted fixes for some
  client failures that are different from deleting the general cache.
- **The server shows an EOS/EOL warning:** the server owner must update server artifacts; players
  cannot repair that by clearing local cache.
- **The problem is inside one QBCore resource:** collect the client/server error and troubleshoot the
  resource before repeatedly wiping caches.

The current [Cfx client-issues guide](https://docs.fivem.net/docs/support/client-issues/) explicitly
uses targeted fixes for several errors. Prefer the documented fix when your error matches one.

## FiveM cache location

The common FiveM client data path on Windows is:

```text
%localappdata%\FiveM\FiveM.app\data
```

The cache directories covered by this guide are:

```text
cache
server-cache
server-cache-priv
```

If your FiveM application data is installed elsewhere, use the actual FiveM application-data
location rather than inventing a second copy of these folders.

## What the cache folders are for

From a troubleshooting perspective, treat the folders like this:

| Folder | Practical role | When to consider clearing it |
| --- | --- | --- |
| `cache` | General cached client/downloaded data | Stale or corrupted cached content after an update |
| `server-cache` | Cached server/resource data | One server keeps serving old or inconsistent downloaded content |
| `server-cache-priv` | Additional private server cache data | Server-specific cache problems persist after a narrower cleanup |

The exact internal cache implementation can change. The important troubleshooting distinction is
that deleting these folders forces FiveM to rebuild/redownload cached data; it does not change the
server's source code or repair upstream services.

## Recommended: selective cache clear

Start with the narrowest change that matches the symptom.

### 1. Close FiveM

Exit FiveM normally. If Windows reports that a cache file is still in use, check Task Manager for a
remaining FiveM process and close that process before deleting files.

### 2. Open the data directory

Press `Win + R` and enter:

```text
%localappdata%\FiveM\FiveM.app\data
```

### 3. Delete the relevant cache folder

If the problem is tied to one server or a recent server-resource update, start with the server cache
rather than deleting unrelated application data.

For a broader cache reset, remove:

```text
cache
server-cache
server-cache-priv
```

### 4. Restart FiveM

Launch FiveM and reconnect. Expect required server assets to download again.

### 5. Reproduce the original problem

Do not treat a successful launch as proof that the issue is fixed. Repeat the action that originally
failed and check F8/client logs and server logs if the problem returns.

## When clearing cache can help

Cache cleanup is a reasonable diagnostic step for symptoms such as:

- old textures, models, NUI or other downloaded server assets still appearing after an update,
- a server resource appearing locally stale while other players receive the current version,
- a suspected corrupted local cache after an interrupted resource download,
- a reproducible server-specific client issue that disappears on a clean cache.

It should be one controlled troubleshooting step, not a default response to every FiveM problem.

## When clearing cache will not fix the root cause

### Server is not reachable

If direct connection fails because of firewall, port-forwarding, DNS, proxy or server configuration,
clearing local cache does not change that infrastructure.

Use the [FiveM server-connection troubleshooting](/docs/troubleshooting/connection-issues) guide or
the upstream [Cfx server-issues documentation](https://docs.fivem.net/docs/support/server-issues/).

### Server artifacts are outdated

Cfx EOS/EOL warnings require the server owner to update server artifacts. The
[Cfx EOS/EOL documentation](https://docs.fivem.net/docs/server-manual/end-of-support-end-of-life/)
states that the player does not fix the red EOL condition locally.

### Authentication or entitlement errors

Follow the exact Cfx client-support article for the displayed error. Authentication files are not
general cache and should not be deleted as routine maintenance.

### QBCore resource errors

If F8 or the server console names a QBCore resource, export, event, SQL query or dependency, fix that
technical cause. A cache clear can refresh downloaded client assets, but it cannot repair bad Lua,
missing SQL, invalid configuration or the wrong resource load order.

Start with [QBCore troubleshooting](/docs/troubleshooting).

### GTA V or game-storage problems

FiveM uses additional game storage and requires a supported Windows/GTA V installation. Do not
delete `game-storage` as part of a normal server-cache cleanup. Follow the exact Cfx support path for
game-storage or installation errors instead.

## What not to delete as routine cache cleanup

Avoid broad deletion of:

- the entire `%localappdata%\FiveM` directory,
- the entire `%appdata%\CitizenFX` directory,
- `game-storage`,
- GTA V documents/save folders,
- authentication or entitlement files,
- logs you still need for diagnosis.

Some official Cfx support procedures intentionally remove a specific file for a specific error. That
does not make those files general-purpose cache-cleaning targets.

For example, Cfx currently documents a targeted `caches.xml` removal for certain component-loading
errors. Follow that procedure only when the matching error applies.

## FiveM needs to update game cache / game storage errors

Do not assume that `server-cache` or `server-cache-priv` is the cause. A game-cache or game-storage
message can concern the local game installation rather than one server's downloaded resources.

Use this order:

1. record the exact FiveM error text,
2. restart FiveM once,
3. confirm GTA V and Windows meet current FiveM requirements,
4. follow the matching Cfx client-support article,
5. only clear the general/server cache when the error or recent server changes make cached content a
   plausible cause.

## Server owners: diagnose before telling every player to clear cache

If many players report the same issue immediately after a deployment, investigate the deployment
first.

Check:

- resource startup errors,
- manifest/file declarations,
- changed asset filenames,
- CDN/proxy behavior,
- load order and dependencies,
- whether the same issue reproduces on a clean test client.

Do not add undocumented convars to `server.cfg` as a generic cache fix. Use current Cfx/QBCore
documentation for the actual subsystem involved.

## FAQ

### Should I clear FiveM cache every month?

No. There is no reason to treat cache deletion as scheduled maintenance. Clear it when you are
diagnosing stale or corrupted cached content.

### Do I need to restart Windows?

Usually not. Close FiveM first. Restart Windows only when a process or file lock persists and you
cannot cleanly stop it.

### Should I clear Steam's download cache too?

Not for a normal FiveM server-cache problem. Steam's download cache is a different subsystem. Use
Steam troubleshooting only when the GTA V/Steam installation itself is implicated.

### Why is the first reconnect slower after clearing cache?

FiveM has to rebuild or download data that was previously cached.

### Can clearing cache fix a broken QBCore script?

It can refresh client-downloaded assets, but it cannot fix broken Lua, SQL, configuration,
dependencies, permissions or server-side state.

### Is FiveM supported on macOS or Linux as a normal client?

The current Cfx system requirements list supported Windows versions for the FiveM client. This guide
therefore documents the supported Windows client path instead of publishing speculative macOS/Linux
cache paths.

## Related troubleshooting

- [QBCore troubleshooting](/docs/troubleshooting)
- [Connection issues](/docs/troubleshooting/connection-issues)
- [Resource load order](/docs/troubleshooting/resource-load-order)
- [Cfx client issues](https://docs.fivem.net/docs/support/client-issues/)
