PRINTER KIOSK WEB

https://laravel.com/docs/10.x

Docker deployment

A work-in-progress Docker deployment can be started by running:

docker-compose up -d

This starts up a MariaDB container as well as a container for the main application.

Note that this is not yet suitable for development work. If you change the contents of files, it will not be reflected.

Installation

First, clone this repository and check out the correct branch.

git clone [email protected]:louie-github/lea004-print-conet.git
git checkout alpha-testing

Then, install dependencies via Composer.

composer install

Note: If you are deploying this server to production, you can run the alternative command:

composer install --optimize-autoloader

Then, set up your .env file:

cp .env.example .env

Importantly, change the line below to match the URL at which you will be hosting the web app:

KIOSK_URL=https://print-conet.947825.xyz

Moreover, you should also change the lines below to match your database setup:

DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=password

Make sure that you have already created the necessary users and databases beforehand.

Then, generate your app key and run the initial migrations and seeders:

php artisan key:generate
php artisan migrate:fresh --seed

Then, install the necessary Node modules:

npm install

Development server

In a development environment, please run both the Vite hot reload server and a web server.

To run the Vite hot reload server, run:

npm run dev

To run the development web server, run:

php artisan serve

By default, this will expose your web app at http://localhost:8000.

Production deployment

If you are running this server in production, you do not need to run the Vite hot reload server. Instead, run:

npm run build

Please follow Laravel's deployment guide to optimize your web application. As a starting point, you can run these commands to cache some important values:

php artisan config:cache
php artisan event:cache
php artisan route:cache
php artisan view:cache

Then, serve your PHP web application using your web server of choice, such as Apache, NGINX, or Caddy.

Alternatively, you can also make use of Laravel Octane. By default, frankenphp is configured as the default web server. Ensure that it is installed on your system, then run:

php artisan octane:start

Initial Account

By default, an admin account and test account will be created.

Administrator account:

email: [email protected]
pass: secret

Test account:

email: [email protected]
pass: password