# Installation

## Downloading

Once you've purchased the product, head over to [**store.hamz.dev**](https://store.hamz.dev), in the top right click your Discord ID then you'll be presented with the products you own. Click the **Download** button next to Hamz CAD.

## Choosing a Domain

You now have to decide if you want to access your CAD via your main domain, or a sub-domain.

A main domain would be **hamzcad.com**

A sub-domain would be **cad.hamzcad.com**

If you want to use the main domain, please continue with the instructions below. However, if you want to use a sub-domain, pause here, and [click here](https://docs.hamz.dev/#sub-domain-setup) to learn how to set up a sub-domain.

<details>

<summary>PHP Configuration Requirements</summary>

For this product, you must use:&#x20;

* PHP Version 7.4 (If you are using the In-Game UI, use PHP 7.2)
* PHP `output_buffering` set to 4096

</details>

## Uploading the Files

Next, head into your Web Hosting control panel.

Under the **Files** tab, select **File Manager**.

<figure><img src="https://1343677498-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmh5jQDhFVLCuJsqAc1xh%2Fuploads%2FnFcPnT5yt58fZ3n2yEYn%2Fuploading.png?alt=media&#x26;token=ceac44a0-d047-4909-b6e4-ec6b36c77941" alt=""><figcaption></figcaption></figure>

Once the **File Manager** has opened in a separate tab, select **public\_html**

If you wish to use a sub-domain, select the appropriate folder otherwise click **Upload** in the menu at the top.

<figure><img src="https://1343677498-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmh5jQDhFVLCuJsqAc1xh%2Fuploads%2Fiva3myDihQ1WFSxGTwow%2Fuploading-1.png?alt=media&#x26;token=4ce636cb-e189-45bb-a0eb-bb5e3f48ee78" alt=""><figcaption></figcaption></figure>

Select the .zip folder that you previously downloaded from the store.

## Extracting the Files

Once the files have been uploaded, right-click on the new .zip folder and click **Extract**.

<figure><img src="https://1343677498-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmh5jQDhFVLCuJsqAc1xh%2Fuploads%2FQ7NU6OYaVRHBRjRnTwmd%2Fextract.png?alt=media&#x26;token=12421f71-74c1-4047-94a3-be39c180a0b9" alt=""><figcaption></figcaption></figure>

Once you've accepted the following Extract prompts, you'll then be presented with two folders. One is your .zip file, and one is the folder you just extracted; you can now delete the .zip folder.

## File Management

Enter the "HAMZ CAD V3" folder, and then enter the "WEB FILES" folder.

Click "Select All" from the above menu, and drag them all into the correct folder in the structure on the left. Example: **public\_html**

<figure><img src="https://1343677498-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmh5jQDhFVLCuJsqAc1xh%2Fuploads%2FrcU0khO5Kd6CNVoOeJIY%2Ffile-management.png?alt=media&#x26;token=bdf3cb92-9963-4eed-8df9-2c2210361808" alt=""><figcaption></figcaption></figure>

## MySQL Database

You now need to create a database and user for the CAD system to run on.&#x20;

Head back into cPanel, and look for **MySQL Databases**

Under the **New Database**, enter a unique name for the CAD database. Example: **cad**

<figure><img src="https://1343677498-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmh5jQDhFVLCuJsqAc1xh%2Fuploads%2FnpW573ZQFSFbt7pwqJfg%2Fimage.png?alt=media&#x26;token=7520cfde-5983-401f-b493-5e63b2da51e6" alt=""><figcaption></figcaption></figure>

Once the name is chosen, select **Create Database**.

Next, you'll need to make a MySQL Use&#x72;**.** Scroll down on the same page to the **Add New User** section. Again, choose a unique name for the username. Example: **admin**

Use cPanel to generate a unique password, and save it to a notepad document.

<figure><img src="https://1343677498-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmh5jQDhFVLCuJsqAc1xh%2Fuploads%2FzM7oDiQO6e0RRtejjrQq%2Fimage.png?alt=media&#x26;token=f6deb961-8489-4738-ace8-6962e4b764b4" alt=""><figcaption></figcaption></figure>

Once you've got the password, saved, click **Use Password** which will then fill out the form fully, and hit **Create User**.

<figure><img src="https://1343677498-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmh5jQDhFVLCuJsqAc1xh%2Fuploads%2FP1bov1cFDDWlaaCNGlfl%2Fimage.png?alt=media&#x26;token=5d57bf2b-22b5-49f6-91c8-4bb72ddfbb31" alt=""><figcaption></figcaption></figure>

Next, we need to add the permissions to the user to that database we've just created. At the bottom of the page select the **User** and **Database** and then click **Add**.

<figure><img src="https://1343677498-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmh5jQDhFVLCuJsqAc1xh%2Fuploads%2F0Sq2YTSxVbtbT5HtizP0%2Fimage.png?alt=media&#x26;token=6f3bdde5-dc27-4023-b8ee-bebb06a7fb77" alt=""><figcaption></figcaption></figure>

Ensure that **All Privileges** are selected, so that it has full permissions to that database. Once completed click **Make Changes**.

<figure><img src="https://1343677498-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmh5jQDhFVLCuJsqAc1xh%2Fuploads%2F5CY65vIvdnQwZQwEK235%2Fimage.png?alt=media&#x26;token=cae57a61-44d6-443a-ba4f-ccacc5ca7f1b" alt=""><figcaption></figcaption></figure>

## Database Import

Now that we have the database created, we're going to want to import the database that comes with the CAD system to that database we've just made.&#x20;

Head back into cPanel, but this time select **PHPMyAdmin**.

<figure><img src="https://1343677498-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmh5jQDhFVLCuJsqAc1xh%2Fuploads%2FjLFuCP4tGCMLlASIG9gT%2Fimage.png?alt=media&#x26;token=5bd06037-2a88-4ba2-a9ed-1990d25bc062" alt=""><figcaption></figcaption></figure>

Select the database you've just created from the left menu.

<figure><img src="https://1343677498-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmh5jQDhFVLCuJsqAc1xh%2Fuploads%2FXoZOltQIUFfs4vuKhFl8%2Fimage.png?alt=media&#x26;token=2d8adb58-4de7-414a-b596-511453db6171" alt=""><figcaption></figcaption></figure>

Select **Import** from the menu bar

<figure><img src="https://1343677498-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmh5jQDhFVLCuJsqAc1xh%2Fuploads%2FQJ5d48ySwLDqww9tNnyq%2Fimage.png?alt=media&#x26;token=2f14c36f-cedf-48b8-b7ff-433a5b73406f" alt=""><figcaption></figcaption></figure>

Select the **.mysql** file that was in the downloaded folder.

<figure><img src="https://1343677498-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmh5jQDhFVLCuJsqAc1xh%2Fuploads%2FjrYadlUDbcwHEQ64wcoZ%2Fimage.png?alt=media&#x26;token=9d25e0a1-20dd-4305-a697-0d3a2f88d7d9" alt=""><figcaption></figcaption></figure>

Lastly, click **Import**.&#x20;


---

# 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://docs.hamz.dev/hamz-cad/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.
