Menu

Theme

Core and versions · Fix · CHECKED ON 5.0.0

Logisim Java runtime environment: which Java does Logisim need?

Logisim Java runtime environment: if you install Logisim-evolution with the .msi, .dmg, .deb or .rpm, you need no Java runtime environment at all: each installer includes its own. Only the -all.jar needs Java, and since version 3.9.0 it must be Java 21 or newer: on Java 8 or 17 it stops with UnsupportedClassVersionError. Classic Logisim 2.7.1 runs on Java 17 and 21.
FOR
Jar users, Mac and Linux users · Logisim-evolution 5.0.0, classic 2.7.1
CHECKED
9 Nov 2026
FIX TIME
about 5 min
Checked against Logisim-evolution 5.0.0 on 5 machines
On this page

Find your error

Find the message you see, then read the matching section below.

Error: A JNI error has occurred, please check your installation and try again

Terminal or a console window. Java 8 with the 5.0.0 jar (F20).

java.lang.UnsupportedClassVersionError: com/cburch/logisim/Main has been compiled by a more recent version of the Java Runtime (class file version 65.0), this version of the Java Runtime only recognizes class file versions up to 52.0

Printed under the JNI error. Java 8 (F20). Fix: Java 21 or an installer.

Error: LinkageError occurred while loading main class com.cburch.logisim.Main

Followed by: class file version 65.0 ... up to 61.0. Java 17 with the 5.0.0 jar (F20).

java.awt.AWTError: Assistive Technology not found: org.GNOME.Accessibility.AtkWrapper

Classic 2.7.1 on Ubuntu's Java 8 (F21). Jump to the classic section.

Two more things you may see are not Java messages we could capture ourselves. Mac users report a prompt that starts “To open Logisim you need to install the legacy Java SE 6 runtime” when they open the old classic app. Windows users report that double-clicking the jar does nothing or opens it in WinRAR or 7-Zip. Both are covered below.

Decoder. The number in the error is the Java the program was built for:

Class file version Java
52 Java 8
55 Java 11
61 Java 17
65 Java 21

The rule in one table

FeatureJava neededTested by usInstaller has Java
Classic 2.7.1 (2011)Java needed: partialJava 5 or newer per its author; ran on 17 and 21Tested by us: yesJava 17, 21 (F21, F58, F64). Java 8 on Ubuntu needs the fix belowInstaller has Java: removedno installer: the jar
Logisim-evolution 2.15Java needed: partialJava 8Tested by us: untestedInstaller has Java: removednot applicable
Logisim-evolution 3.4.1Java needed: partialJava 11Tested by us: untestedInstaller has Java: removednot applicable
Logisim-evolution 3.8.0Java needed: partialJava 16Tested by us: yesopens our files on Java 21 (F68)Installer has Java: untestednot checked
Logisim-evolution 3.9.0 to 4.1.0Java needed: partialJava 21Tested by us: yes4.1.0 opens our files on Java 21 (F68)Installer has Java: untestednot checked
Logisim-evolution 5.0.0 jarJava needed: partialJava 21Tested by us: yesfails on 8 and 17, runs on 21 (F20)Installer has Java: nono: needs Java 21
Logisim-evolution 5.0.0 installersJava needed: yesnone neededTested by us: yesinstalled and started on Windows, macOS, Linux (F35)Installer has Java: yesyes, a different runtime per platform (F27)

The Java minimum per version comes from the release data on our release history page. The installers bundle these runtimes (F27): Microsoft OpenJDK 21.0.4 on Windows, Oracle Java 25.0.2 on the Apple Silicon Mac, Eclipse Temurin 21.0.12.1 on the Intel Mac and Oracle Java 26.0.1 on Linux.

Package managers and Java:

Channel What you get Java
winget the official MSI included (F56)
Flathub version 5.0.0 its own OpenJDK 21 (F52)
Snap version 3.8.0 (stale) OpenJDK 17.0.6 (F53)
Chocolatey, Scoop the -all.jar you install Java 21 yourself (F57)
AUR logisim-evolution-bin the jar the package says Java 16, but 5.0.0 needs 21 (F55, F20)

Fastest fix: use the installer instead of the jar

The installer for your system includes a Java that Logisim keeps to itself, so there is nothing to install and nothing to match. Get it from the download page. You lose nothing for normal use. The command line still works through the program’s own launcher, without any Java on your PATH (F28):

File launcher paths
C:\Program Files\logisim-evolution\logisim-evolution.exe
/Applications/Logisim-evolution.app/Contents/MacOS/Logisim-evolution
/opt/logisim-evolution/bin/logisim-evolution

If you must use the jar: install Java 21

You need the jar when a course names it, when Chocolatey or Scoop gave you the jar (Chocolatey says “Java needs to be installed before using Logisim Evolution”, F57), for the AUR package, or for a grading script.

On Windows

  1. Install Temurin 21

    Download the Windows .msi for Temurin 21 from adoptium.net and run it. In the feature list, enable “Set JAVA_HOME variable” and “Associate .jar”. These steps are from Adoptium; we did not run them on a desktop.

    Check: The installer finishes.

  2. Check the version

    Open Command Prompt and run:

    Command Prompt
    java -version
    

    Check: The first line says 21 or higher.

  3. Run the jar

    Go to the folder that holds the file and run:

    Command Prompt
    java -jar logisim-evolution-5.0.0-all.jar
    

    Check: The Logisim window opens.

On macOS

  1. Install Temurin 21

    Download the macOS .pkg for Temurin 21 from adoptium.net. Pick the aarch64 file for an Apple Silicon Mac and the x64 file for an Intel Mac. These steps are from Adoptium; we have not run the jar route for 5.0.0 on a Mac (T-INST-M05).

    Check: The package installs.

  2. Check the version

    Terminal (macOS)
    java -version
    

    Check: The first line says 21 or higher.

  3. Run the jar from Terminal

    Terminal (macOS)
    java -jar ~/Downloads/logisim-evolution-5.0.0-all.jar
    

    Check: The Logisim window opens.

On Linux

  1. Install Java 21

    On Ubuntu 24.04 and similar:

    Terminal
    sudo apt install openjdk-21-jre
    

    On Fedora:

    Terminal
    sudo dnf install java-21-openjdk
    

    We did not run these two commands for this page.

    Check: The package installs.

  2. Check and run

    Terminal
    java -version
    java -jar logisim-evolution-5.0.0-all.jar
    

    Check: java -version says 21 or higher, then the window opens.

Several Javas installed? Make sure the right one runs

java -version shows the Java that comes first on your PATH. Our Windows test machine had Java 17 first, and with that one the 5.0.0 jar would fail (F20). Run the jar with the full path of the Java 21 program instead, for example "C:\Program Files\Eclipse Adoptium\jdk-21...\bin\java.exe" -jar logisim-evolution-5.0.0-all.jar, with the folder name from your own computer. The Java 8 you get from java.com is Oracle’s consumer Java 8, and Logisim 5.0.0 cannot use it.

The jar opens in WinRAR or 7-Zip, or nothing happens

On Windows, a jar is a ZIP file, so an archive program may have claimed it. Right-click the file, choose Open with, and pick Java (Temurin’s “OpenJDK Platform binary”). Or start it from Command Prompt as shown above. Or skip all of this and use the MSI. See also Logisim will not open.

Classic Logisim 2.7.1 and Java

Classic 2.7.1 ran on Java 17 and 21 in our tests: on Windows with Temurin 17.0.21 (F58) and on macOS 15 with Temurin 21.0.13 (F64).

LAB ci-w25 · GitHub-hosted Windows Server 20252.7.12026-11-09

Classic Logisim 2.7.1 on a Windows 11 desktop: a window titled "Logisim: main of Untitled" with a toolbar, the circuit tree (Wiring, Gates, Plexers, Arithmetic, Memory, Input/Output, Base) and an empty dotted canvas.

Classic 2.7.1 started on Windows with Temurin 17.0.21 and was still running with its window on screen after 15 seconds (F58).ci-w25-l271-main-window-01
Classic Logisim 2.7.1 on Windows 11: a window titled main of Untitled with the circuit tree and an empty canvas.
LAB ci-mac-arm · GitHub-hosted macOS 152.7.12026-11-09

Classic Logisim 2.7.1 on a macOS 15 desktop: a window titled "Logisim: main of Untitled" with the toolbar, the circuit tree and an empty dotted canvas. The menu bar says Main, and a Java icon is in the Dock.

Classic 2.7.1 opened from its jar on macOS 15 with Temurin 21.0.13 (F64).ci-mac-arm-l271-main-window-01
Classic Logisim 2.7.1 on macOS: a window titled main of Untitled with an empty canvas and a Java icon in the Dock.

On Ubuntu’s Java 8 it crashes with the AtkWrapper error shown above. Either use a newer Java, or tell Java not to load the accessibility helper (F21):

Terminal
java -Djavax.accessibility.assistive_technologies=" " -jar logisim-generic-2.7.1.jar

Users also report a second fix: comment out the assistive_technologies line in the system’s accessibility.properties file. On a Mac, do not install Java SE 6 for the old app, as some handouts suggest. Run the jar on a current Java instead. More in classic Logisim 2.7.1 today.

Course jars and old Evolution versions

Courses name different Javas. Use the newest Java your version accepts. Running older jars on a newer Java worked for classic 2.7.1 on 21 in our tests (F21); we have not tried the old Evolution jars from 2.15 on Java 21, so we do not promise it.

Does Logisim install Java on my computer?

No. The runtime in an installer belongs to Logisim, sits inside its program folder, for example C:\Program Files\logisim-evolution\runtime\ on Windows, and goes away when you uninstall (F25, F26, F27). It does not show up as “Java” in your list of programs, so it is also fine on school computers that ban Java.

Frequently asked questions

Does Logisim need Java?

The installers for Logisim-evolution 5.0.0 (.msi, .dmg, .deb, .rpm, portable .zip) bring their own Java, so you do not install any. The -all.jar and classic Logisim 2.7.1 do need Java on your computer.

Which Java version does Logisim need?

The 5.0.0 jar needs Java 21 or newer. We saw it fail on Java 8 and 17 and run on Java 21. Classic 2.7.1 ran on Java 17 and 21 in our tests.

Can I run Logisim without Java?

Yes: use an installer. The Java inside it is private to Logisim, sits in the program folder and is removed when you uninstall.

What does "class file version 65.0" mean?

It is the Java version the program was built for. 65 is Java 21, 61 is Java 17 and 52 is Java 8. If your Java is older than the number in the error, install Java 21.

Is Java 8 enough for Logisim?

Not for Logisim-evolution 3.9.0 and newer. Java 8 stops the 5.0.0 jar with a JNI error. Java 8 still works for old versions such as 2.15 and for classic 2.7.1, which needs the AtkWrapper fix on Ubuntu.

Sources

  1. Releases and their Java requirement, logisim.dev release data, logisim.dev lab data: research/upstream/releases.json
  2. Eclipse Temurin downloads, Adoptium, accessed 11 Nov 2026
  3. Java runs and error texts, logisim.dev lab data: test-data/lab1-2026-11-09-linux-local/logs/java8-le.txt, java17-le.txt, java21-le.txt, java8-271.txt

Try: , , ,