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 againTerminal 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.0Printed under the JNI error. Java 8 (F20). Fix: Java 21 or an installer.
Error: LinkageError occurred while loading main class com.cburch.logisim.MainFollowed 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.AtkWrapperClassic 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
| Feature | Java needed | Tested by us | Installer has Java |
|---|---|---|---|
| Classic 2.7.1 (2011) | Java needed: partialJava 5 or newer per its author; ran on 17 and 21 | Tested by us: yesJava 17, 21 (F21, F58, F64). Java 8 on Ubuntu needs the fix below | Installer has Java: removedno installer: the jar |
| Logisim-evolution 2.15 | Java needed: partialJava 8 | Tested by us: untested | Installer has Java: removednot applicable |
| Logisim-evolution 3.4.1 | Java needed: partialJava 11 | Tested by us: untested | Installer has Java: removednot applicable |
| Logisim-evolution 3.8.0 | Java needed: partialJava 16 | Tested by us: yesopens our files on Java 21 (F68) | Installer has Java: untestednot checked |
| Logisim-evolution 3.9.0 to 4.1.0 | Java needed: partialJava 21 | Tested by us: yes4.1.0 opens our files on Java 21 (F68) | Installer has Java: untestednot checked |
| Logisim-evolution 5.0.0 jar | Java needed: partialJava 21 | Tested by us: yesfails on 8 and 17, runs on 21 (F20) | Installer has Java: nono: needs Java 21 |
| Logisim-evolution 5.0.0 installers | Java needed: yesnone needed | Tested 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):
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
Install Temurin 21
Download the Windows
.msifor 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.
Check the version
Open Command Prompt and run:
java -versionCheck: The first line says 21 or higher.
Run the jar
Go to the folder that holds the file and run:
java -jar logisim-evolution-5.0.0-all.jarCheck: The Logisim window opens.
On macOS
Install Temurin 21
Download the macOS
.pkgfor Temurin 21 from adoptium.net. Pick theaarch64file for an Apple Silicon Mac and thex64file 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.
Check the version
java -versionCheck: The first line says 21 or higher.
Run the jar from Terminal
java -jar ~/Downloads/logisim-evolution-5.0.0-all.jarCheck: The Logisim window opens.
On Linux
Install Java 21
On Ubuntu 24.04 and similar:
sudo apt install openjdk-21-jreOn Fedora:
sudo dnf install java-21-openjdkWe did not run these two commands for this page.
Check: The package installs.
Check and run
java -version java -jar logisim-evolution-5.0.0-all.jarCheck: 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).
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 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.
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):
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.