First Launch Setup

Prepare MailPolicy before creating the first admin

This startup page keeps the required Windows bootstrap, initial import locations, and manual PowerShell script locations in one place. Finish these prerequisites first, then create the first administrator and the dashboard will appear.

Download Bootstrap PS1 Download Bootstrap CMD Download Worker Installer Download Setup Guide 
powershell -ExecutionPolicy Bypass -File .\scripts\windows\bootstrap-mailpolicy.ps1 -ProjectRoot "W:\WWW_PHP8.2\MailPolicy" -PhpPath "D:\laragon\bin\php\php-8.2.0-Win32-vs16-x64\php.exe" -InstallWorker -ServiceUser ".\mailpolicy-sync" -ServicePassword "YOUR_WINDOWS_PASSWORD" -StartWorker

Prerequisite Check

Recommended first-run requirements from inside this application package.

Ready

Application bootstrap script

Run the bundled bootstrap once to prepare storage, queue settings, migrations, cache clear, and optional worker install.

Needs Setup

Queue transport configured

Current value: direct | Recommended: queue

Ready

Initial import files location ready

W:\WWW_PHP8.2\MailPolicy\storage\app/mailpolicy\lists

Ready

Manual script location ready

W:\WWW_PHP8.2\MailPolicy\storage\app/mailpolicy\scripts

Files to Provide

Put your initial import and manual sync files directly inside the app storage paths below.

W:\WWW_PHP8.2\MailPolicy\storage\app/mailpolicy\lists\Initial_AllowedDomains.txt
W:\WWW_PHP8.2\MailPolicy\storage\app/mailpolicy\lists\Initial_AllowedSenders.txt
W:\WWW_PHP8.2\MailPolicy\storage\app/mailpolicy\lists\Initial_BlockedMailDomains.txt
W:\WWW_PHP8.2\MailPolicy\storage\app/mailpolicy\scripts\AllowedDomainSync.ps1
W:\WWW_PHP8.2\MailPolicy\storage\app/mailpolicy\scripts\AllowedSendersSync.ps1

What to do before admin creation

1. Run the bundled bootstrap once

Use the downloaded bootstrap PS1 or CMD file to prepare folders, queue settings, migrations, cache clear, and optional worker install.

2. Copy your initial files into the app

Place initial domains, senders, and blocked domains under the listed storage folder inside this project.

3. Copy your manual PowerShell scripts into the app

Place your domain and sender sync PS1 files inside the listed script paths in this same project.

4. If using queue worker mode, configure the Windows service user

Grant Log on as a service, project folder access, and certificate private key read access to the worker account.

Create First Admin

Create the first administrator only after the setup items above are complete.