Installation

This guide covers setting up the Security Guard Admin application from the provided source code.

Requirements

PHP 8.2 or newer.
Composer 2.x.
Node.js 20 or newer.
MySQL 8.0 (or MariaDB 10.6, PostgreSQL 15, SQL Server 2019).
A web server (Apache, Nginx, or Laravel Valet).

Initial Setup Wizard

1. Visit the application URL in your browser. 2. The Setup page appears on first visit. 3. Enter the admin name, email, and password to create the admin user account. 4. After setup completes, sign in with the credentials you provided.

Demo Site

Demo website: https://securityguard.xcodesol.com/
Email: admin@example.com
Password: password

Web Server Configuration

Nginx

nginx

server {
    listen 80;
    server_name guards.example.com;
    root /path/to/security-guard-admin/public;

    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-Content-Type-Options "nosniff";

    index index.php;

    charset utf-8;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }

    error_page 404 /index.php;

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}

Apache

Ensure mod_rewrite is enabled and place the following in your virtual host or .htaccess:

apache

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^ index.php [L]
</IfModule>

After Installation

Open the application, sign in with your admin credentials, and proceed to configuration to set up your company profile and attendance mode.

XcodeSol Security Guard Admin Documentation