AutoCom Docs

Installation Wizard

The Installation Wizard guides you through the initial setup process. It automatically detects your environment and walks you through four simple steps.

Accessing the Wizard

When you first visit your Auto Commerce installation, you'll be automatically redirected to the Installation Wizard at /install if the application hasn't been configured yet.

Step 1: Requirements Check

The wizard verifies that all system requirements are met before proceeding.

Checks performed:

  • PHP version (8.2+ required)
  • Required PHP extensions (pdo, mbstring, openssl, redis, etc.)
  • Database connection (PostgreSQL or MySQL)
  • Redis connection
  • Directory permissions (storage/, bootstrap/cache/)

If any requirement fails, you'll see a clear error message explaining what needs to be fixed. Common issues include:

  • Missing PHP extensions
  • Incorrect database credentials in .env
  • Redis not running or wrong password
  • Directory permission issues

Fix any issues shown and click "Re-check" to verify again.

Step 2: Database Setup

This step configures your database for Auto Commerce.

Actions performed:

  1. Runs all database migrations
  2. Generates Laravel Passport encryption keys (for OAuth authentication)
  3. Creates the personal access client for API authentication

The wizard uses your .env database configuration to connect and set up the schema.

Step 3: Initial Data

Seeds the database with essential configuration data.

Data seeded:

Category Details
Roles 5 default roles: Owner, Admin, Manager, Agent, Viewer
Permissions 68 granular permissions across 12 categories
Modules Default module configurations
Settings System settings initialization

This provides a complete RBAC (Role-Based Access Control) system out of the box.

Step 4: Create Owner Account

The final step creates your first organization and admin account.

Required information:

Field Description Requirements
Organization Name Display name for your company Max 255 characters
Organization ID Unique identifier Lowercase, hyphens allowed, max 50 chars
Admin Name Your full name Max 255 characters
Email Login email address Valid email format
Password Account password Minimum 8 characters
Confirm Password Password confirmation Must match password

Once submitted, the wizard creates:

  • Your user account
  • Your organization (tenant)
  • Links your account to the organization with Owner role

Completion

After successful completion, you'll see a confirmation screen with:

  • Your organization name and ID
  • A button to proceed to the login page

Log in with the email and password you just created to access your dashboard.

What Happens Next?

After installation, you should:

  1. Configure Integrations - Connect your e-commerce platforms, shipping providers, and communication channels
  2. Invite Team Members - Add team members and assign appropriate roles
  3. Enable 2FA - Set up two-factor authentication for enhanced security
  4. Configure Queue Worker - Ensure background jobs are processing
  5. Set Up Backups - Configure automated database and file backups

Re-running the Wizard

The wizard only runs once. After successful completion, a .installed file is created in storage/ to mark the installation as complete.

If you need to reinstall:

  1. Delete the .installed file: rm storage/.installed
  2. Drop and recreate the database
  3. Access the application to start the wizard again

Warning: This will delete all data. Only do this on a fresh installation or for development purposes.