This installs PHP 8.3, Composer, and related dependencies, clones WemX from GitHub, and applies a sensible web server configuration so you can finish setup in the browser.

bash install-wemx.sh

Great option for smaller apps & development

Choose SQLite in the web interface and provide the path for database file (default path recommended).

To understand file path and permissions for SQLite on Laravel, see: Laravel SQLite Configuration

Choose MySQL in the web interface.

If you are running MySQL on Linux, you can create the database and user with:

# Ubuntu/Debian
sudo apt update && sudo apt install -y mysql-server
sudo systemctl enable --now mysql

Open MySQL CLI

sudo mysql

Then run this inside the MySQL prompt, replace password with your actual password

CREATE DATABASE wemx CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'wemx_user'@'127.0.0.1' IDENTIFIED BY 'your_strong_password';
GRANT ALL PRIVILEGES ON wemx.* TO 'wemx_user'@'127.0.0.1';
FLUSH PRIVILEGES;
EXIT;

Use these values in the web installer:

• Host: 127.0.0.1
• Port: 3306
• Database: wemx
• Username: wemx_user
• Password: the password you set above

Retrieve your connection values (host, port, database name, username, password) from:

• your server/database panel (cPanel, Plesk, cloud provider, etc), or
• your database administrator if this is managed internally.

Useful references: MySQL 8.0 Manual

Choose Postgres in the web interface.

If you are running PostgreSQL on Linux, you can create the database and user with:

# Ubuntu/Debian
sudo apt update && sudo apt install -y postgresql postgresql-contrib
sudo systemctl enable --now postgresql

Open PostgreSQL CLI

sudo -u postgres psql

Then run this inside the PostgreSQL prompt, replace password with your actual password

CREATE DATABASE wemx;
CREATE USER wemx_user WITH ENCRYPTED PASSWORD 'your_strong_password';
GRANT ALL PRIVILEGES ON DATABASE wemx TO wemx_user;
\q

Use these values in the web installer:

• Host: 127.0.0.1
• Port: 5432
• Database: wemx
• Username: wemx_user
• Password: the password you set above

Retrieve your connection values (host, port, database name, username, password) from your PostgreSQL hosting dashboard or infrastructure team.

Useful references: PostgreSQL Documentation

Choose Postgres By URL in the web interface if your provider gives a single connection string (for example Supabase, Neon, Railway, Render).

Create your database/project in the provider dashboard, then copy the full PostgreSQL connection URL from provider settings.

Provider docs:

• Supabase Database Connection String
• Neon Connection Details

If you use another supported Laravel database driver, you can configure it manually in .env instead of the web form.

Create the database and credentials with your provider/admin first, then configure them according to Laravel docs: Laravel Database Configuration

After this go back to the web installer, if the connection details are valid, the web installer will show the new connection.