Installation Guide

Option 1: Installer (Recommended)

1. Download IM3270.Setup.0.44.2.exe
2. Run the installer and follow the prompts
3. Launch IM3270 from the Start Menu

Option 2: PowerShell Script

Run as Administrator:

irm https://raw.githubusercontent.com/stcarmi/im3270-releases/main/scripts/install-windows.ps1 | iex

Option 1: RPM Package (Recommended)

1. Download and install the RPM:

   wget https://github.com/stcarmi/im3270-releases/releases/download/v0.44.2/im3270-0.44.2.x86_64.rpm
   sudo dnf install im3270-0.44.2.x86_64.rpm

2. Install s3270 4.x (build from source):

   Important: sudo dnf install x3270-x11 installs outdated v3.x which will not work. You must build s3270 4.x from source.

   sudo dnf install gcc make openssl-devel
   wget https://x3270.bgp.nu/download/04.04/suite3270-4.4ga6-src.tgz
   tar xzf suite3270-4.4ga6-src.tgz && cd suite3270-4.4
   ./configure --enable-s3270 --disable-tcl3270 && make s3270 && sudo make install.s3270

3. Run:

   im3270

Option 2: Quick Install Script

curl -fsSL https://raw.githubusercontent.com/stcarmi/im3270-releases/main/scripts/install-fedora.sh | bash

Option 3: Manual Installation (tar.gz)

1. Download & verify (optional):

   wget https://github.com/stcarmi/im3270-releases/releases/download/v0.44.2/im3270-0.44.2-linux.tar.gz
   wget https://github.com/stcarmi/im3270-releases/releases/download/v0.44.2/SHA256SUMS
   sha256sum -c SHA256SUMS --ignore-missing

2. Extract & install:

   sudo mkdir -p /opt/im3270
   sudo tar -xzf im3270-0.44.2-linux.tar.gz -C /opt/im3270 --strip-components=1

3. Create link & run:

   sudo ln -sf /opt/im3270/im3270 /usr/local/bin/im3270
   im3270

Option 1: DEB Package (Recommended)

1. Download and install the DEB:

   wget https://github.com/stcarmi/im3270-releases/releases/download/v0.44.2/im3270_0.44.2_amd64.deb
   sudo dpkg -i im3270_0.44.2_amd64.deb
   sudo apt-get install -f    # install dependencies if needed

2. Install s3270 4.x (build from source):

   Important: sudo apt install x3270 installs outdated v3.x which will not work. You must build s3270 4.x from source.

   sudo apt install gcc make libssl-dev
   wget https://x3270.bgp.nu/download/04.04/suite3270-4.4ga6-src.tgz
   tar xzf suite3270-4.4ga6-src.tgz && cd suite3270-4.4
   ./configure --enable-s3270 --disable-tcl3270 && make s3270 && sudo make install.s3270

3. Run:

   im3270

Option 2: Quick Install Script

curl -fsSL https://raw.githubusercontent.com/stcarmi/im3270-releases/main/scripts/install-ubuntu.sh | bash

Option 3: Manual Installation (tar.gz)

1. Download & verify (optional):

   wget https://github.com/stcarmi/im3270-releases/releases/download/v0.44.2/im3270-0.44.2-linux.tar.gz
   wget https://github.com/stcarmi/im3270-releases/releases/download/v0.44.2/SHA256SUMS
   sha256sum -c SHA256SUMS --ignore-missing

2. Extract & install:

   sudo mkdir -p /opt/im3270
   sudo tar -xzf im3270-0.44.2-linux.tar.gz -C /opt/im3270 --strip-components=1

3. Create link & run:

   sudo ln -sf /opt/im3270/im3270 /usr/local/bin/im3270
   im3270

1. Update WSL:

   wsl --update

2. Install s3270 4.x in WSL (build from source):

   sudo apt install gcc make libssl-dev
   wget https://x3270.bgp.nu/download/04.04/suite3270-4.4ga6-src.tgz
   tar xzf suite3270-4.4ga6-src.tgz && cd suite3270-4.4
   ./configure --enable-s3270 --disable-tcl3270 && make s3270 && sudo make install.s3270

3. Install IM3270 (DEB package — recommended):

   wget https://github.com/stcarmi/im3270-releases/releases/download/v0.44.2/im3270_0.44.2_amd64.deb
   sudo dpkg -i im3270_0.44.2_amd64.deb
   sudo apt-get install -f    # install dependencies if needed
   im3270

4. Or install from tar.gz:

   wget https://github.com/stcarmi/im3270-releases/releases/download/v0.44.2/im3270-0.44.2-linux.tar.gz
   wget https://github.com/stcarmi/im3270-releases/releases/download/v0.44.2/SHA256SUMS
   sha256sum -c SHA256SUMS --ignore-missing
   sudo mkdir -p /opt/im3270
   sudo tar -xzf im3270-0.44.2-linux.tar.gz -C /opt/im3270 --strip-components=1
   sudo ln -sf /opt/im3270/im3270 /usr/local/bin/im3270
   im3270