Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.

1. 1

   Clone the repository

   git clone https://github.com/ramosramosramos/pay-vault-ledger-payroll-system.git
   cd pay-vault-ledger-payroll-system

   Copy
2. 2

   Install the required runtimes

   Node.js 22, PHP ^8.3

   # needs nvm: https://github.com/nvm-sh/nvm
   nvm install 22
   sudo apt install php-cli php-mbstring php-xml php-curl unzip composer  # Debian/Ubuntu

   Copy
3. 3

   Configure environment variables

   Fill in secrets: APP_KEY, REDIS_PASSWORD, MAIL_PASSWORD, AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY

   cp .env.example .env

   Copy
4. 4

   Install dependencies

   npm ci
   composer install

   Copy
5. 5

   Set up the database / app

   php artisan key:generate
   php artisan migrate

   Copy
6. 6

   Run it

   Run each command in its own terminal.

   npm run dev
   php artisan serve

   Copy