IA ICT AssetAsset intelligence for modern teams Get in Touch
Installation Guide

Deploy ICTAsset on your live server with the built-in auto installer.

This guide explains how to prepare your hosting environment, run the installation wizard, migrate the database, create the administrator account, and secure the deployment for production use.

Installer flow

Built-in web installer steps

  • Welcome screen at /install
  • Server requirement and writable path checks
  • Database and application URL configuration
  • Automatic migration and RBAC seeding
  • Optional demo data import
  • Administrator account creation
Best for

Shared hosting, VPS, and on-prem servers

The installer is designed for live deployments where the application files are already uploaded and web access is available. It works well with common environments such as cPanel hosting, CloudPanel servers, XAMPP, and AMPPS, in addition to standard Apache or Nginx VPS deployments.

Recommended URL after upload: https://your-domain.com/install

1. Prepare the live server

Make sure the hosting environment matches the installer checks before opening the wizard.

1

Server software

  • PHP 8.2 or newer
  • MySQL, MariaDB, PostgreSQL, or SQLite
  • Apache or Nginx with PHP support
  • HTTPS configured for production
2

Supported environments

  • cPanel shared hosting or VPS hosting
  • CloudPanel-managed PHP servers
  • XAMPP for local or staging deployments
  • AMPPS for local or staging deployments
3

Required PHP extensions

  • BCMath
  • Ctype
  • JSON
  • Mbstring
  • OpenSSL
  • PDO and PDO MySQL
  • Tokenizer, XML, Fileinfo, Zip, cURL, GD
4

Writable paths

  • storage/app
  • storage/framework
  • storage/logs
  • bootstrap/cache
  • public

2. Upload the application

Place the project on the live server and point your web root to the application public directory.

File deployment
  • Upload the full application package to the server.
  • Keep the Laravel project structure intact.
  • Point the domain or subdomain document root to the public folder.
  • If using shared hosting without document root control, place the app carefully and expose only public web files.
Database readiness
  • Create the database before running the installer.
  • Create a database user with full privileges on that database.
  • Keep the host, port, database name, username, and password ready.
  • For SQLite, prepare a writable database file path.
Environment examples: use cPanel or CloudPanel on live hosting, and XAMPP or AMPPS for local testing before production deployment.

3. Run the auto installer

Open the installer in a browser and follow the guided steps.

01

Open the installer

Visit /install on your domain. If the platform is not yet marked as installed, the setup wizard will start.

02

Review requirements

The installer checks PHP version, required extensions, and writable directories. Fix any failed check before continuing.

03

Enter application and database settings

Provide the application name, live URL, database driver, host, port, database name, username, and password. The installer validates the connection before saving the environment file.

04

Run migration

The wizard clears caches, generates the app key if needed, runs database migrations, seeds roles and permissions, and optionally loads demo data.

05

Create the admin account

Create the primary administrator login that will manage users, permissions, settings, and system configuration after installation.

What the installer writes

Automatic actions during setup

  • Creates or updates the .env file
  • Sets APP_ENV=production and APP_DEBUG=false
  • Runs migrations with force mode
  • Seeds RBAC permissions
  • Attempts to create the storage link
  • Marks the app as installed in storage/installed
Post-install checklist

Production hardening steps

  • Verify HTTPS and correct APP_URL
  • Confirm mail settings if notifications are needed
  • Restrict file permissions appropriately
  • Back up the database and application files
  • Remove or block public access to installer routes after deployment policy review
  • Log in as admin and review roles, settings, and branding

Troubleshooting on live hosting

These are the most common deployment issues for shared hosting and VPS environments.

A

Installer cannot continue

  • Enable missing PHP extensions in the hosting panel
  • Update folder ownership or writable permissions
  • Make sure the server is using the correct PHP version
B

Database connection fails

  • Double-check DB host and port
  • Confirm database user privileges
  • Verify remote DB access if the database is on another server
C

Migration step fails

  • Review server logs and Laravel logs
  • Ensure storage and bootstrap/cache are writable
  • Check that the SQL user can create and alter tables