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

# Installation

### 1. Installation

1. Unzip the `jg-vehiclestudio-bundle`.
2. Drag the script folder (`jg-vehiclestudio`) into a new folder called `[jg]` within your server's `resources` folder.
3. Make sure you have the latest version of [ox\_lib](https://github.com/overextended/ox_lib/releases/latest) installed.
4. Optional: If you are planning to use a database for data storage, see Data Storage and make sure [oxmysql](https://github.com/overextended/oxmysql/releases/latest) is installed on your server.
5. Inside your `server.cfg`, add a new line after your framework, dependencies, and other required resources have started:

```
ensure [jg]
```

### 2. Configuration

Inside the `config` folder you will find the main configuration files.

The main file is:

```
config/config.lua
```

Private upload credentials live in:

```
config/config.upload.lua
```

Do not put real upload API keys in public GitHub repositories, support tickets, or screenshots.

### 3. Pick Image Upload Storage

Before using Vehicle Studio on a live server, choose where generated images should be stored.

For live servers, we strongly recommend a remote upload provider:

```lua
Config.ImageStorageProvider = "qbox"
Config.ImageStorageProvider = "fivemanage"
Config.ImageStorageProvider = "r2"
Config.ImageStorageProvider = "s3"
```

Local storage is mainly for localhost testing:

```lua
Config.ImageStorageProvider = "local"
```

**⚠️ Local storage does not work out of the box on most live servers because the in-game browser blocks uploads to plain HTTP public IPs.** Only use local storage on a live server if you have set up your own HTTPS reverse proxy.

Read the image upload guide before taking lots of photos:

* [Image Uploads Docs](/vehicle-studio/image-uploads.md)
* [Local Storage Guide](/vehicle-studio/image-uploads/local-storage.md)

### 4. Data Storage

Vehicle Studio can store its data in local files or in a database.

If you want to change where data is stored, follow the [Data Storage Docs](/vehicle-studio/data-storage.md).

### 5. Quick Start

Our quick start guide makes it easy to get up and running with JG Vehicle Studio:

{% content-ref url="/pages/YZ63jPOO6ul29ZZO4QDW" %}
[Quick Start](/vehicle-studio/quick-start.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://docs.jgscripts.com/vehicle-studio/installation.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.