# Run local ## Install in MAMP, WAMP, XAMMP You can easily install the project locally if you use [MAMP](https://www.mamp.info/), [WAMP](https://sourceforge.net/projects/wampserver/) (Window only) or [XAMMP](https://www.apachefriends.org/download.html). In this example / guide, we will use [MAMP](https://www.mamp.info/), but should be similar in the other tools. ### Step 1 - Setup MAMP First, extract the zip that contains the project source code, that you download from CodeCanyon. Next install MAMP on you computer. You will be presented with screen like this one. Make sure PHP version is 8.1+ Then click on preferences

Go in the server tab, and in the "Document root" choose the folder where you extracted the code. Click OK.

MAMP is now set up. Click on start button and then on WebStart button.

### Step 2 - Database creation You will be presented with a page like this one.

Click on Tools -> phpMyAdmin to create your database.

Click on new, and then enter your database name. Remember the name

### Step 3 - Install

Next, go back to start page, and click on "My Website"

Install will now start. Click on "Next step"

In case you get permission errors. Open the file manager and change permission on the folders

After permissions are ok, click on "Next step"

Enter database port, and database name. Enter desired admin user and pass.

There are two other screens, that you can click on "Next step" After that install is done

You can visit the landing page. or the login page ## Run local - Docker way From Laravel 8, there is a new package available called . We use this to run the site locally and test it. #### Step 1 - Install Docker All you need is to install on your computer. After that extract the code and open it in the Terminal / Command prompt ``` cd PROJECT_NAME ./vendor/bin/sail up ``` The first time you run this can take some time #### Step 2 - Install via CMD After sail is running, open a new terminal window and navigate to the project. execute ``` sail artisan migrate --fresh --seed ``` This will set up ( seed ) the database. Then execute / run ``` cd storage touch installed ``` This should create an empty file in **storage** folder, to let the system know that the project is installed. Then open the site on [localhost](http://127.0.0.1). You should see the site now Login with the default credentials **Username**: **Password**: secret --- # 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://mobidonia.gitbook.io/qr-menu-pdf/docs/run-locally.md?ask= ``` 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.