Manual Installation Guide
Cloning the Repository
Start by opening your terminal and cloning the Skeleton repository:
git clone --depth=1 git@git.qlic.nl:qore/skeleton.git myproject
Navigate to the project directory and copy the .env.example file to .env:
cd myproject
cp .env.example .env
Generate a default password used in seeders
echo "ADMIN_PASSWORD=$(openssl rand -base64 12)" >> .env
echo "APP_KEY=base64:$(openssl rand -base64 32)" >> .env
This installation assumes you have already authenticated with Packistry. If you haven’t done so, please complete that step first.
You can find the relevant guide here: Packistry Authentication Guide
Installing Dependencies
Now, install the required dependencies:
composer install
If you encounter an issue with ext-imagick not being installed for PHP, you can either install it manually, use Docker, or bypass it (since it is only used for image manipulation) with:
composer install --ignore-platform-reqs
If you want to install redis and imagick locally:
# Redis (source: https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/install-redis-on-mac-os/)
brew install redis
brew services start redis
sudo pecl install -f redis
# Imagick (source: https://matthewsetter.com/install-php-imagick-extension-macos/)
brew install imagemagick
brew install pkg-config
sudo pecl install -f imagick
Database Setup
You can either use a local MySQL setup or set up the database using Docker.
Update your .env file (keeping DB_USERNAME as root is recommended), then start the Docker container:
docker compose up -d
Finishing the Setup
The application is almost ready to run. You can either run it via Docker or use php artisan serve.
Ensure you have the latest qore/system migrations by running:
php artisan vendor:publish --tag=qore.system.db
composer fresh
php artisan storage:link
# Or if you are using docker:
docker exec -it $(docker ps -q --filter "name={name_of_project}-web-1") sh -c "php artisan storage:link"
# where {name_of_project} is the name of the project folder by default
Running the Frontend
Navigate to the /frontend directory in your project and run the following commands:
cp .env.example .env
yarn && yarn dev
Everything is now set up! You can log in using the default credentials:
Email: admin@qlic.nl
Password: Configured in .env ADMIN_PASSWORD