Installation

Choosing the download

The download page proposes the setup for your operating system and processor; change either choice if it guessed wrong.

All of them are 64-bit only: Windows 10 or 11, macOS Tahoe, Sequoia, Sonoma, Ventura or Monterey, and a 64-bit Linux with GTK 3. Every platform can also add iiziGo to an existing Eclipse instead (below).

Windows

With the installer

1. Download the Windows installer for your processor (x64 or ARM64). It is signed by Mindus SARL.
2. Open it and follow its steps.
3. The installer creates a folder on the desktop and one in the Start menu, each with a shortcut to iiziGo and links to the documentation and guides, the Java API documentation, the downloads and the Mindus home page.

To remove iiziGo, uninstall it from Windows' Settings (Apps) or from the Control Panel (Programs and Features).

With the signed archive

The archive (iiziGo-5.0.0.build-win64.jar, or -arm64.jar for ARM64) is the same iiziGo without an installer. A signed .jar file is a zip archive:

1. Extract it with a zip tool into a folder of your choice. It holds one folder, iiziGo.
2. Start iiziGo.exe in that folder, and create a shortcut to it yourself if you want one.

To remove this iiziGo, delete its folder.

macOS

1. Download the disk image for your Mac: Apple Silicon or Intel. It is signed by Mindus SARL and notarized by Apple.
2. Open the disk image and drag the iiziGo app to your Applications folder (or another folder of your choice).
3. Start iiziGo from that folder. The first time, macOS asks whether to open an app downloaded from the Internet: choose Open.

The download page also offers the app as an archive (.tar.gz), as Eclipse builds it, for a Mac where the disk image cannot be used. To remove iiziGo, move the app to the Trash.

Linux

iiziGo for Linux runs on a 64-bit Linux desktop with GTK 3. The archive holds one folder, iiziGo, with the program and its Java runtime.

1. Download the archive for your processor: iiziGo-5.0.0.build-linux.gtk.x86_64.tar.gz or ...-linux.gtk.aarch64.tar.gz.
2. Extract it in your home folder:

   tar -xzf iiziGo-5.0.0.build-linux.gtk.x86_64.tar.gz -C ~

3. Add it to your application menu, and with --desktop also to your desktop:

   ~/iiziGo/add-icon.sh --desktop

4. Start it from the menu or the desktop, or from its folder:

   ~/iiziGo/iiziGo

The menu entry starts this copy of iiziGo and the dock groups its window under the iiziGo icon; a second extracted iiziGo gets an entry of its own. To remove iiziGo, run ~/iiziGo/remove-icon.sh, which removes exactly the entries that add-icon.sh created, and delete the folder ~/iiziGo.

Adding iiziGo to an existing Eclipse

iiziGo can be installed into an Eclipse you already use, on any of the platforms above. That Eclipse must be:

• Eclipse 2026-09 (4.41) or later, in 64-bit;
• running on Java 25 LTS or later, 64-bit, as a full Java Development Kit (a JRE will not do), preferably OpenJDK “Temurin” from Eclipse Adoptium. Eclipse shows the Java it runs on in Help > About Eclipse IDE > Installation Details > Configuration (the line java.version).

1. In Eclipse, choose Help > Install New Software...
2. Press Add... and enter the IIZI update site as the location:

   https://support.iizi.co/downloads/builds/latest/p2/

3. Check IIZI Platform, press Next, accept the license agreements and press Finish.
4. Restart Eclipse when it asks.

Eclipse then takes iiziGo's updates from the same site, with Help > Check for Updates.

The first start

The workspace

At its start iiziGo asks for a workspace, the folder that holds your projects and iiziGo's settings. It proposes iizi-workspace in your home folder; any folder will do. Open a workspace of iiziGo 4.8 only from a copy: iiziGo 5 changes its settings (see Upgrading from 4.x).

The license

iiziGo 5.0 installs the license system but does not enforce it: iiziGo shows its license state, with a setup wizard and the trial days, and never disables an IIZI function. A license problem is a warning; nothing is refused. iiziGo connects to the license server mls.mindus.co on port 443; see Licensing for the settings that name another server or none.

Your account. Window > Preferences > IIZI (on macOS: the iiziGo menu > Settings > IIZI) shows your Developer ID, e-mail address and license state. To change your password, choose Change user or password; in the wizard that opens, click Next and then choose to Sign In, sign in again with the same e-mail address and your current password, and tick Change password. If you have forgotten your password, use the link Forgotten your password? on the sign-in page: a code is mailed to you; it can take a few minutes to arrive.

The development server and the /apps page

iiziGo has a development server built in, which serves your applications while you design them. Its web server takes the first free pair of ports: HTTP 2800 to 2809 and HTTPS 4800 to 4809 – 2800 and 4800 when they are free – so that two iiziGo can run side by side. The status line shows the port, and Preferences > IIZI > Web server sets the preferred ones.

• The /apps page, http://localhost:2800/apps with the default port, links to the panels of your projects in each of their languages, for a Browser on this computer or on a device.
• /apps, the Design Viewer and Cast to Device can be reached from other devices of your network. The Designer's own page in an external Browser answers this computer only, unless “Allow the Designer from other computers” is on.
• The /apps page of the IIZI Development Server (iiziGo’s Run configuration of that name) has a Launch link per application for iiziRun Developer and iiziRun Custom: on this computer it shows a QR code that a phone scans to launch the application. Open the page by the computer’s network address, not localhost, so that the phone can reach it; see Launch iiziRun apps from a link or a QR code.

Documentation and guides: www.iizi.co.

Next: Installing iiziServer · Upgrading from 4.x · System requirements

Back to IIZI Support