Your cPanel needs Setup Node.js App. Installing takes about five minutes.
- Create a database (skip this to use SQLite). In MySQL Databases: create a database, add a user with a strong password, then Add User To Database and tick ALL PRIVILEGES. cPanel adds a prefix to both names, such as
youruser_webfazeandyouruser_wf. Write the full names down. - Upload the deploy package. In File Manager, create a folder outside
public_html, for example/home/youruser/webfaze, upload the zip from webfaze.com Account → Downloads and extract it there. Keeping it outsidepublic_htmlmeans your database file and secrets can never be served over the web. - Create the app. Setup Node.js App → Create Application:
- Node.js version: 22.15 or higher
- Application mode: Production
- Application root:
webfaze - Application URL: your domain
- Application startup file:
app.js - Add the variables with Add Variable:
DB_HOST(localhost),DB_NAME,DB_USER,DB_PASSWORD, thenWEBFAZE_DOMAIN,WEBFAZE_SITE_NAME,WEBFAZE_ADMIN_EMAILandWEBFAZE_ADMIN_PASSWORD(12+ characters). Don't setPORTorWEBFAZE_HOST: cPanel handles them. - Restart the app, open
https://yourdomain.com/adminand sign in. - Delete
WEBFAZE_ADMIN_PASSWORDfrom the app's variables. - Activate your licence under Settings → Advanced → Licence.
Prefer the setup screens? Leave out the four WEBFAZE_* variables. After starting, open the app's log file, copy the link ending in /install?t=…, and open it on your domain within 30 minutes.
"Cannot find module" in the log usually means the Node.js version is too old. Change it in the app's settings and restart.