How to install Cognex In-Sight Explorer on Linux using Wine

thijs · September 2, 2026, 12:19am

Based on contributions by aron.

Cognex In-Sight Explorer is Windows-only software, but it can run on Linux through Wine, a compatibility layer that translates Windows API calls to POSIX equivalents (it does not emulate a Windows system). This how-to installs In-Sight Explorer 6.5.1 on Linux via Wine. It was tested working on Ubuntu 24.04 and Fedora 43.

Wine only supports x86/x64 platforms. ARM and Apple Silicon are not supported — installing under Rosetta 2 on Apple Silicon has been reported to hang during the .NET installation step. Other distributions than the two tested here may also work, but haven’t been verified.

What you need

A Linux (or other POSIX) machine with an x86 or x64 CPU.
Wine version 11 or later. This is recent enough that most distro repositories don’t package it yet — download it directly from WineHQ’s wiki instead.
winetricks: available from your distro’s repositories, or from the Winetricks GitHub repo.
The Cognex In-Sight Explorer 6.5.1 installer, from the official Cognex website.

Steps

1. Create a Wine prefix

Wine stores a virtual C: drive, registry, and related files in a location called a “Wine prefix”, set via the WINEPREFIX environment variable (if unset, it defaults to ~/.wine). It’s good practice to use a separate prefix per application, so each one gets only the dependencies it needs, for example one prefix for an old Windows 7-era .NET application and another using Windows 11-style settings.

mkdir -p ~/.local/share/wineprefixes/cognex
export WINEPREFIX="$HOME/.local/share/wineprefixes/cognex"
wineboot --init

2. Install Cognex’s dependencies with winetricks

Cognex In-Sight Explorer depends on .NET 4.5.2. Running the installer without the right prefix configuration (for example the Windows version needs to be set correctly) causes the download to fail. winetricks automates this, so you only need to tell it which components to install:

winetricks remove_mono

winetricks dotnet452

winetricks dotnet35sp1

You can add the --unattended flag to skip the “please agree to the Terms of Service” popups, but you then also lose the progress bar — which matters here, because dotnet452 can appear to hang for a while (installation typically takes 30–45 minutes) even when it’s actually still working.

3. Run the installer

wine ~/Downloads/Cognex\ In-Sight\ Software\ 6.5.1.exe

4. Allow Wine to open privileged network ports

Cognex needs to open an FTP server on port 21 to work with the simulator (and reportedly with real hardware, though this wasn’t tested by the original author). On Linux, opening ports below 1024 normally requires root. Rather than running Wine with sudo, grant the wineserver binary the specific capability it needs.

First find the real binary behind the symlink:

which wineserver
# /usr/bin/wineserver
ls -l /usr/bin/wineserver
# lrwxrwxrwx. 1 root root 31 ... /usr/bin/wineserver -> /opt/wine-stable/bin/wineserver

Then grant that binary the capability:

sudo setcap "cap_net_bind_service=ep" /opt/wine-stable/bin/wineserver

(use the actual target path from your ls -l output above, it may differ from this example).

This also needs direct access to layer 2 (Ethernet) from the hardware network port, so run this on bare metal — not inside a Docker container or a VM — unless you pass the hardware port through.

5. Run In-Sight Explorer

After installation, In-Sight Explorer should already appear in your application menu or on your desktop. If it doesn’t, launch it directly:

wine $WINEPREFIX/drive_c/Program\ Files\ \(x86\)/Cognex/In-Sight/In-Sight\ Explorer\ 6.5.1/In-Sight\ Explorer.exe

Troubleshooting

dotnet452 install via winetricks appears to hang: this is expected without --unattended’s progress bar; the install can take up to 45 minutes. Give it time before assuming it’s frozen.
FTP/network features (simulator) don’t work: confirm the cap_net_bind_service capability was actually applied to the real wineserver binary (not just the symlink), and that you’re not running inside a container or VM without hardware passthrough.
Install hangs on Apple Silicon under Rosetta 2: this is a known limitation — ARM and Apple Silicon aren’t supported by Wine for this workflow.

Rewritten and consolidated (Sept 2026) from the original student how-to’s: How to install cognex in-sight explorer on linux (and other posix environments).