Dgarratt: Updated by push_wiki.py

2026-09-22T20:13:27Z

Updated by push_wiki.py

New page

'''Install Commander4j''' is step 3 of the [[Install Guide]]. It takes about five minutes. Have your installer file from [[Downloads]] ready.

== Windows ==

Double-click the downloaded <code>Commander4j_''version''_windows-x64_with_jre.exe</code>. Windows may show a ''User Account Control'' prompt asking whether to allow the app to make changes: click ''Yes''.

[[File:Install1.png|400px]]

The installer opens with a welcome page. Click ''Next''.

[[File:Install2.png|400px]]

Read the licence agreement (Commander4j is free software under the GNU General Public License v3), select ''I accept the agreement'' and click ''Next''.

[[File:Install3.png|400px]]

Choose where to install. The default, <code>C:\Commander4j</code>, is fine. Click ''Next''.

[[File:Install4.png|400px]]

Choose the install type. The rule:

* '''Full''' if this is the only computer, or the server that other PCs will connect to. Full includes the interface service for ERP messages and the Clone4j database-copy tool.
* '''Workstation''' for every other PC. It installs just the application and Setup4j.

Click ''Next''.

[[File:Install5.png|400px]]

The Start Menu folder is called ''Commander4j''. Leave it, unless you are installing a second copy on the same PC, in which case give it a different name. Click ''Next''.

[[File:Install6.png|400px]]

The files are copied.

[[File:Install7.png|400px]]

Click ''Finish''. The Start menu now has a ''Commander4j'' folder containing the '''Commander4j''' application and the '''Setup4j''' tool (plus Clone4j on a Full install).

[[File:Desktop_icons.png|500px]]

'''Next step:''' [[Setup4j]].

== macOS ==

# Open the downloaded <code>.dmg</code> file. A window shows the '''Commander4j''' folder and an ''Applications'' shortcut. Drag the folder onto ''Applications''.
# Open your Applications folder, then the Commander4j folder inside it. It contains '''Commander4j''', '''Setup4j''' and, on the full install, '''Clone4j'''.
# The first time you open Setup4j or Commander4j, macOS refuses because the installer is not signed with Apple. '''Right-click''' (or Control-click) the app and choose '''Open''', then click ''Open'' again in the warning. On macOS 15 and later you may instead need to go to ''System Settings'', ''Privacy & Security'', scroll down and click ''Open Anyway''. You only have to do this once per app.

'''Next step:''' [[Setup4j]].

== Linux ==

The Linux installer does not include Java. Install Java 25 first; the [https://www.azul.com/downloads/?package=jdk#zulu Azul Zulu JDK] is recommended. Then, in a terminal:

chmod +x Commander4j_''version''_linux.sh
sudo ./Commander4j_''version''_linux.sh

Follow the same screens as the Windows installer. Commander4j installs to <code>/opt/Commander4j</code> by default (or <code>~/Commander4j</code> without <code>sudo</code>), with launcher scripts for <code>Commander4j</code> and <code>Setup4j</code> in that folder.

'''Next step:''' [[Setup4j]].

== Installing over an older version ==

Running a newer installer on a PC that already has Commander4j offers to update the existing installation in place. Your database connections are kept. Afterwards, run Setup4j and click ''AUTO Update DB'' so the database matches the new version. See [[Upgrading]] for the details and the screenshots.

[[Category:Commander4j]]

Install Commander4j - Revision history

Dgarratt: Updated by push_wiki.py