Skip to main content
Use the native setup for application development when you do not need the complete OIE, PACS, and simulator stack. It uses SQLite by default and starts the Laravel server, queue listener, and Vite together.

​
Prerequisites

  • Git
  • PHP 8.5
  • Composer 2
  • Node.js 22 and npm
Confirm the tools before cloning:
1

Clone the repository

2

Run the project setup

The Composer setup script installs PHP and Node dependencies, creates .env when missing, generates APP_KEY, runs migrations, and builds frontend assets.
3

Create local reference data

For a disposable local database, run the development seeder:
This creates a development administrator. Sign in with admin@example.com and password, then change the password if the database will be retained.
4

Start the development processes

Keep this terminal open. The script starts the application server, the database queue listener, and Vite.
5

Open HMIS

Use the URL printed by php artisan serve, normally http://127.0.0.1:8000.
Never run the broad DatabaseSeeder in staging or production. It creates the known admin@example.com / password account and example organization data.

​
Useful development commands

​
Reset disposable local data

This command deletes all local database content and recreates it. Use it only against the SQLite database or another confirmed disposable development database.

​
Stop the environment

Press Ctrl+C in the terminal running composer dev. Confirm no separate queue or Vite process remains before changing branches or deleting the working directory. Continue with environment and test data and local verification.