Skip to main content

Administrator panel

info

Before proceeding with the installation, ensure that Java is properly installed and configured on your system. For instructions, refer to our Java installation guide.

The Administrator Panel is a desktop application used to configure and manage the MSH Postfix Milter server. This guide covers downloading and launching the application on Windows, Linux, and macOS.

Download​

Navigate to the Download page on this site and click the Download for Desktop button. You will receive a file named msh-pm-admin-VERSION.zip.

The archive contains the following files:

FileDescription
msh-pm-admin.exeWindows executable - recommended launcher for Windows
msh-pm-admin.batWindows batch file - locates Java automatically and launches the application
msh-pm-admin-simple.batWindows batch file - uses java directly from PATH without auto-detection
msh-pm-admin.jarJava application archive (platform-independent)
msh-pm-admin.shShell script for Linux and macOS - locates Java automatically and launches the application

Windows​

Installation​

  1. Extract the downloaded msh-pm-admin-VERSION.zip archive to a directory of your choice.
  2. Open the extracted folder.

Launching​

Double-click msh-pm-admin.exe to start the application.

If the .exe does not launch correctly, try one of the batch file alternatives:

  • msh-pm-admin.bat - attempts to locate Java automatically before launching.
  • msh-pm-admin-simple.bat - uses java directly from the system PATH.

Running from a batch file opens a console window alongside the application. A successful startup produces output similar to:

17:13:45.807 [main] INFO  msh.pm.admin.AdminEntry - -------------------------------------------------------
17:13:45.822 [main] INFO  msh.pm.admin.AdminEntry -    MSH Postfix Milter (admin)
17:13:45.829 [main] INFO  msh.pm.admin.AdminEntry -    Version 1.0.0
17:13:45.845 [main] INFO  msh.pm.admin.AdminEntry - -------------------------------------------------------

After launching, the Administrator Panel window will appear.

Main application window after first run

Linux​

Installation​

Extract the downloaded archive:

unzip msh-pm-admin-VERSION.zip

Launching​

Make the shell script executable (first run only) and start the application:

chmod +x msh-pm-admin/msh-pm-admin.sh
./msh-pm-admin/msh-pm-admin.sh

A successful startup produces output similar to:

17:13:45.807 [main] INFO  msh.pm.admin.AdminEntry - -------------------------------------------------------
17:13:45.822 [main] INFO  msh.pm.admin.AdminEntry -    MSH Postfix Milter (admin)
17:13:45.829 [main] INFO  msh.pm.admin.AdminEntry -    Version 1.0.0
17:13:45.845 [main] INFO  msh.pm.admin.AdminEntry - -------------------------------------------------------

After launching, the Administrator Panel window will appear.

Main application window after first run

macOS​

Installation​

Extract the downloaded archive:

unzip msh-pm-admin-VERSION.zip

Launching​

Make the shell script executable (first run only) and start the application:

chmod +x msh-pm-admin/msh-pm-admin.sh
./msh-pm-admin/msh-pm-admin.sh
note

On macOS, Gatekeeper may block the application on first launch. If you see a security warning, open System Settings → Privacy & Security and click Open Anyway next to the blocked item.

A successful startup produces output similar to:

17:13:45.807 [main] INFO  msh.pm.admin.AdminEntry - -------------------------------------------------------
17:13:45.822 [main] INFO  msh.pm.admin.AdminEntry -    MSH Postfix Milter (admin)
17:13:45.829 [main] INFO  msh.pm.admin.AdminEntry -    Version 1.0.0
17:13:45.845 [main] INFO  msh.pm.admin.AdminEntry - -------------------------------------------------------

After launching, the Administrator Panel window will appear.

Main application window after first run

Additional resources​

Troubleshooting​

If you encounter issues during installation or launch, refer to:

What's next​

After successfully launching the Administrator Panel, you might want to: