Getting Started

This page provides a suggested sequence for getting Commander4j up and running for the first time.

1. Check Requirements

Before installing, confirm that your environment meets the Requirements. You will need:

A supported operating system (Windows 10/11, macOS, or Linux)
A supported database (MySQL, MariaDB, MS SQL Server, or Oracle) installed and accessible
Java 21 (included in the Windows installer; required separately on Linux)

For shop-floor scanner access you will also need Apache Tomcat 11.x. See Requirements for the full list.

2. Install Commander4j

Follow the Installation guide to install the application and configure your database connection. The Setup4j tool is used to create and test your database connection settings (stored in hosts.xml).

3. Log In

See Default Username & Password for the initial login credentials. On first login you will be prompted to change the default password.

See Logon for a description of the login process and account states.

4. Configure Core Reference Data

Before the system can be used for production, you need to populate the core reference tables. A suggested order is:

Locations — define your warehouse and production locations
Units of Measure — define the units used for materials and weights
Materials — add your product and material records (this is the most important step)
Customers — add your customer records (or edit the default SELF record with your company name)
Process Orders — create or import your first production orders

5. Set Up Users and Security

Create Groups representing different roles (e.g. Warehouse, Quality, Admin)
Assign modules to each group via the Permissions screen
Create user accounts and assign them to the appropriate groups
Review System Keys for password policy and other global settings

6. Configure Printing

If you are printing pallet or case labels:

Define your Printer Queues
Assign printers to users or workstations
For automatic labelling lines, see Production Lines & Labellers

7. Explore the Modules

With reference data in place, explore the main functional areas:

Production Confirmation and Despatch for day-to-day operations
Inspections and Quality Control Sample for quality management
Waste Recording for waste tracking
Weight Checks Module for weight compliance