Installation

macOS

1. Download the .dmg for your architecture:
   • Apple Silicon (M1/M2/M3/M4): KoreShell_x.x.x_aarch64.dmg
   • Intel: KoreShell_x.x.x_x86_64.dmg
2. Open the .dmg and drag KoreShell to /Applications
3. On first run macOS may show "KoreShell can't be opened" — go to System Settings → Privacy & Security → Open Anyway

:::tip Apple Silicon If you're unsure which chip you have: Apple menu → About This Mac. "Apple M1/M2/M3/M4" = Silicon. Intel = x86_64. :::

Windows

1. Download KoreShell_x.x.x_x64.msi
2. Run the installer (click More info → Run anyway on the SmartScreen prompt)
3. KoreShell is installed to %LOCALAPPDATA%\KoreShell\

Linux

AppImage (recommended — any distro)

chmod +x KoreShell_x.x.x_x86_64.AppImage
./KoreShell_x.x.x_x86_64.AppImage

Debian / Ubuntu (.deb)

sudo dpkg -i KoreShell_x.x.x_amd64.deb
koreshell

:::note WebKitGTK KoreShell requires WebKitGTK on Linux. If the app doesn't start, install it:

# Ubuntu / Debian
sudo apt install libwebkit2gtk-4.1-0

# Fedora
sudo dnf install webkit2gtk4.1

:::

Data Locations

Platform	App data directory
macOS	~/Library/Application Support/io.koreshell.desktop/
Windows	%APPDATA%\io.koreshell.desktop\
Linux	~/.local/share/io.koreshell.desktop/

The local SQLite database (koreshell.db) and vault key are stored here.

Uninstalling

Uninstalling the app does not delete your data directory. To fully remove:

# macOS
rm -rf ~/Library/Application\ Support/io.koreshell.desktop/

# Linux
rm -rf ~/.local/share/io.koreshell.desktop/