Skip to content
On this page

Create a LUYA application on Windows and XAMPP

The LUYA installation requires Composer, please have a look at the official Composer website if you haven´t installed on your system yet.

Find the installation Video on Youtube in order to help you install LUYA.

After setting up Composer, we execute the Composer command create-project to checkout the luya-kickstarter application, an out of the box LUYA setup to run your website directly. It´s recommend to run the create-project command directly from your htdocs/webserver folder like this:

sh
composer create-project luyadev/luya-kickstarter:^1.0

Note: During the installation Composer may ask for your GitHub login credentials. This is normal because Composer needs to get enough API rate-limit to retrieve the dependent package information from GitHub. For more details, please refer to the Composer documentation.

Note: In previous versions the fxp Composer plugin was required composer global require "fxp/composer-asset-plugin:~1.4" but this has been replaced with Asset Packagist. If the Asset Packagist is not present in the composer.json, you might install the fxp plugin as it is a "legacy" project setup.

The create-project command will create a folder (inside of your current folder where the composer create-project command was executed) named luya-kickstarter. If the Composer installation is done change into the configs folder inside the application and copy the .dist template files to original .php files.

sh
copy env.php.dist env.php
copy env-local-db.php.dist env-local-db.php

Now the database connection inside the configs/env-local-db.php file needs to fit your MySQL servers configuration. It´s recommend to open all config files once to change values and understand the behavior. In order to understand the config files read more in the environment configs section. After successfully setting up your database connection you have to reopen your terminal and change into your project directory and excute the console command at public_html folder

php command is available if you already add your php.exe path on your system environment variable

Run the migration files with the migrate console command:

Note: If the migration process failed, try to replace localhost with 127.0.0.1 in the database DNS configuration (env-local-db.php) which is located in the configs folder.

sh
php index.php migrate

Build and import all filesystem configurations into the database with the import console command:

sh
php index.php import

At last we execute the setup console command which is going to setup a user, group and permissions:

sh
php index.php admin/setup

The setup proccess will ask you for an email and password to store your personal login data inside the database (of course the password will be encrypted).

php index.php health will make a small check if several directorys are readable etc.

You can now log in into your administration interface http://localhost/luya-kickstarter/admin (depending on where you have located the LUYA files).

Visit the installation problems and questions Site when you have any problems with the LUYA setup.