Create a LUYA Application
The LUYA installation requires Composer. Please have a look at the official Composer website if you haven´t installed it 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 is recommended to run the
create-project command directly from your htdocs/webserver folder like this:
composer create-project luyadev/luya-kickstarter:^1.0
Info: For more LUYA Kickstarter packages, check the kickstarter packages section.
Note: During the installation you may be asked for the 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.
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, switch to configs folder inside the application and copy the
.dist template files to original
cp env.php.dist env.php
Now the database connection inside the
configs/config.php file needs to fit your MySQL servers' configuration. It is recommended 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.
Migrate and Import
After successfully setting up your database connection, you have to reopen your terminal and switch to your project directory and excute the luya binary files, which has been installed into your vendor folder by Composer as described below.
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.
Build and import all filesystem configurations into the database with the import console command:
Finally execute the setup console command command, which is going to setup a user, group and permissions:
The setup process will ask you for an email and password to store your personal login data inside the database (of course the password will be encrypted).
./vendor/bin/luya healthwill make a small check if several directories exist and readable/writable.
You can now log into the administration interface, e.g.
http://localhost/luya-kickstarter/public_html/admin (dependings on the location of the LUYA files).
Check the Installation Problems and Questions Site if you have any problems with the LUYA setup.
When you run the LUYA Kickstarter with docker-compose (see the docker-compose.yml for more details) you start the Docker container by using
Afterwards all dependencies will be installed and a webserver including a database is running. You can now run a specially Docker setup command:
docker-compose exec luya_web setup
This will run the migrate, import and setup command with a default user
email@example.com and password
admin. To run further commands use
docker-compose exec luya_web luya <console_command>
Since the Dockerimage is running on port 80, the docker-compose maps the internal [https://github.com/luyadev/luya-kickstarter/blob/master/docker-compose.yml#L27](port 80 to your machines port 8080) so you can now access your website in the browser under