# Table of Contents - [Install IDA | Hex-Rays Docs](#install-ida-hex-rays-docs) - [What's new? | Hex-Rays Docs](#what-s-new-hex-rays-docs) - [Welcome to Hex-Rays docs | Hex-Rays Docs](#welcome-to-hex-rays-docs-hex-rays-docs) - [What's next? | Hex-Rays Docs](#what-s-next-hex-rays-docs) - [How To Use List Viewers in IDA | Hex-Rays Docs](#how-to-use-list-viewers-in-ida-hex-rays-docs) - [Windows | Hex-Rays Docs](#windows-hex-rays-docs) --- # Install IDA | Hex-Rays Docs * * * By following the steps in this guide, you can successfully install your IDA instance on macOS, Linux, and Windows. The installation steps are valid for all product versions: IDA Pro, IDA Home, or IDA Free. This installation guide is dedicated to individual users. [](#minimum-system-requirements) Minimum system requirements ----------------------------------------------------------------- macOSLinuxWindows macOS 12 (Monterey) or later (x64 or ARM64) x64 (x86\_64) CentOS 7 or later, Ubuntu 16.04 or later. Other equivalent distributions may work but not guaranteed. Windows 8 or later (x64) [](#pre-installation-steps) Pre-installation steps ------------------------------------------------------- Activate your [named](/9.0sp1/getting-started/licensing#named-licenses-activation) or [computer](/9.0sp1/getting-started/licensing#computer-licenses-activation) license via My Hex-Rays portal. ### [](#installation-on-macos) **Installation on macOS** **Prerequisites:** * Ensure that you have [activated your computer/named license](/9.0sp1/getting-started/licensing#license-activation) and downloaded your license file (_ida.hexlic_) locally. * Make sure Python 3 or later is installed on your computer for the IDAPython API to function properly. **Step 1: Download the installer** * Download the macOS version of IDA Pro from Download Center in [My Hex-Rays](https://my.hex-rays.com/) portal. **Step 2: Run the installer** * Extract the .zip archive. * Double-click on the extracted file to run the instalation wizard. * Follow the wizard's instructions to complete the installation: * accept the license agreement and installation directory; * copy your `ida.hexlic` file to IDA installation directory or to `$HOME/.idapro` directory before launching IDA. **Step 4: Launch IDA Pro for the first time** * Double-click on the IDA Pro icon to launch the application. **Step 5: Point to your named/computer license** The step below is valid for named and computer licenses for individual use. If you are going to use floating licenses, check [this](/9.0sp1/getting-started/install-ida#use-floating-license-server) alternative step. * In the License manager pop-up window, specify the path of your license file and click **OK.** You won't be asked about your license again unless the subscription period expires or you move your license file to a different location. * * * ### [](#installation-on-linux) **Installation on Linux** **Prerequisites:** * Ensure that you have [activated your computer/named license](/9.0sp1/getting-started/licensing#license-activation) and downloaded your license file (_ida.hexlic_) locally. * Make sure Python 3 or later is installed on your computer for the IDAPython API to function properly. * Verify that you have the required libraries installed. Use your package manager to install any missing dependencies. Common dependencies include `libx11`, `libxext`, `libxrender`, and `libglib2.0`. **Step 1: Download the installer** * Download the Linux version of IDA Pro from Download Center in [My Hex-Rays](https://my.hex-rays.com/) portal. **Step 4: Run the installer** * Navigate to the directory containing your IDA installer, and make it executable. * Run the installer by double-click it or enter `./linux.run` in the terminal to execute it. * Follow the wizard's instructions to complete the installation: * accept the license agreement and installation directory; * copy your `ida.hexlic` file to IDA installation directory or to `$HOME/.idapro` directory before launching IDA. **Step 5: Launch IDA Pro for the first time** * Go to the directory where IDA is installad and run the command: `./ida90` **Step 6: Point to your named/computer license** The step below is valid for named and computer licenses for individual use. If you are going to use floating licenses, check [this](/9.0sp1/getting-started/install-ida#use-floating-license-server) alternative step. * In the License manager pop-up window, specify the path of your license file and click **OK.** You won't be asked about your license again unless the subscription period expires or you move your license file to a different location. * * * ### [](#installation-on-windows) **Installation on Windows** * Ensure that you have [activated your computer/named license](/9.0sp1/getting-started/licensing#license-activation) and downloaded your license file (_ida.hexlic_) locally. * Make sure Python 3 or later is installed on your computer for the IDAPython API to function properly. **Step 1: Download the installer** * Download the Windows version of IDA Pro from Download Center in [My Hex-Rays](https://my.hex-rays.com/) portal . **Step 2: Run the installer** * Locate the downloaded `.exe` file and double-click it to run the installer. * Follow the installation wizard's instructions to complete the installation: * accept the license agreement and installation directory; * copy your `ida.hexlic` file to IDA installation directory or to `%APPDATA%/Hex-Rays/IDA Pro` directory before launching IDA. **Step 5: Launch IDA Pro for the first time** * Navigate to the Start Menu or desktop shortcut and launch IDA Pro. **Step 6:** **Point to your named/computer license** The step below is valid for named and computer licenses for individual use. If you are going to use floating licenses, check [this](/9.0sp1/getting-started/install-ida#use-floating-license-server) alternative step. * In the License Manager pop-up window, specify the path of your license file and click **OK.** You won't be asked about your license again unless the subscription period expires or you move your license file to a different location. * * * #### [](#use-floating-license-server) Use floating license server **Step 1:** In the License manager pop-up window, select the option _Use floating license server_ and then type a **license server** hostname provided by your administrator. **Step 2:** Borrow one of the licenses visible under the **available licenses** list and click **OK.** Note that you don't need a license file stored on your machine locally while using floating licenses. * * * #### [](#common-post-installation-steps) Common Post-Installation Steps **Step 1: Update IDA Pro** * After installation, check for any available updates. Hex-Rays often releases patches and updates for IDA Pro. You can check for updates within the application via **Help -> Check for free update** or download the latest version from [My Hex-Rays](https://my.hex-rays.com/dashboard/download-center/downloads) portal. **Step 2: Configure environment (optional)** * Customize your IDA Pro environment settings to suit your preferences. This can include configuring hotkeys, and [adjusting appearance settings](/9.0sp1/user-guide/configuration) . **Step 3: Install additional plugins (optional)** * You can extend the functionality of IDA Pro by installing additional plugins that can be found on the official [Hex-Rays repository](https://plugins.hex-rays.com/) or other trusted sources in the reverse engineering community. Last updated 2 months ago Was this helpful? License manager ![](https://docs.hex-rays.com/~gitbook/image?url=https%3A%2F%2F545602138-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FucByjS46IhJacH1pbIKC%252Fuploads%252Fgit-blob-e15fc767f31bf55e90343da5a59ca60269cdd183%252Flicense_manager.png%3Falt%3Dmedia&width=768&dpr=4&quality=100&sign=ad36760e&sv=2) --- # What's new? | Hex-Rays Docs * * * Check the latest changes in the Hex-Rays documentation, including new tutorials and manuals, along with significant revisions to existing content. [](#december-2024) December 2024 ------------------------------------- ### [](#updated-porting-guides) Updated Porting Guides With the recent changes to our API that came into life with SP1 for IDA 9.0, we updated Porting Guides for [IDAPython](/9.0sp1/developer-guide/idapython/idapython-porting-guide-ida-9) and [C++ SDK](/9.0sp1/developer-guide/c++-sdk/c++-sdk-porting-guide-ida-9) . ### [](#new-idapython-examples) New IDAPython examples With the new or reworked IDAPython examples that were added to our [examples library](/9.0sp1/developer-guide/idapython/idapython-examples) , we revamped the examples categories to make the navigation among them more intuitive. Take a look at the new [Working with types](/9.0sp1/developer-guide/idapython/idapython-examples#types) category for samples that utilize our updated Types endpoints. ### [](#revamped-idapython-reference) Revamped IDAPython reference We updated the UI layout of [IDAPython Reference Documentation](https://python.docs.hex-rays.com/) and improve cross-referencing. [](#november-2024) November 2024 ------------------------------------- ### [](#other-updates) Other updates * To reflect the current state of Local Types window as a one hub to all types-related operations, we updated the [Subviews](/9.0sp1/user-guide/user-interface/menu-bar/view/open-subviews) . [](#october-2024) October 2024 ----------------------------------- With IDA 9.0, we changed how the Hex-Rays documentation is organized and added new guides and tutorials to kickstart your IDA journey and ease the migration from previous IDA versions. ### [](#new-structure) New Structure Our docs are divided into three main categories: * [**User Guide**](/9.0sp1/user-guide) , dedicated to individual users and covering whole IDA products (including add-ons, like Teams and Lumina). Most of the documentation regarding IDA, like manuals or tutorials, is currently accessible under the User Guide. * [**Developer Guide**](/9.0sp1/developer-guide) , which focuses on developer's needs, covers the reference and contextual documentation for **IDAPython API** and **C++ SDK**, as well as native **IDC** language. This part is mainly dedicated to plugin authors and devs interested in enhancing basic IDA capabilities with our development kit or scripting. * [**Admin Guide**](/9.0sp1/admin-guide) mainly focuses on administrators installing and managing servers for Teams and Lumina or floating licenses. In [**Archive**](/9.0sp1/archive) , we gathered docs with rather historical value that some of you may still find interesting but focused on previous versions of IDA. ### [](#new-getting-started-guides) New Getting Started Guides We prepared a [Getting Started](/9.0sp1/getting-started) section for IDA newbies and also gathered additional materials to help you find your way around our [IDAPython API](/9.0sp1/developer-guide/idapython/idapython-getting-started) or [IDA SDK](/9.0sp1/developer-guide/c++-sdk/c++-sdk-getting-started) . ### [](#migration-and-porting-guides) Migration and Porting Guides For those familiar with previous versions of IDA, we prepared Porting Guides for [IDAPython](/9.0sp1/developer-guide/idapython/idapython-porting-guide-ida-9) and [C++ SDK](/9.0sp1/developer-guide/c++-sdk/c++-sdk-porting-guide-ida-9) . If you use the Flexera server for floating licenses, check our [Migration Guide for new Hex-Rays license server](/9.0sp1/admin-guide/license-server/hex-rays-license-server-migration-guide) . ### [](#new-features-described) New features described We added installation and setup guides for [IDA Feeds](/9.0sp1/user-guide/plugins/plugins-shipped-with-ida/ida-feeds) plugin and [idalib](/9.0sp1/user-guide/idalib) . Last updated 2 months ago Was this helpful? --- # Welcome to Hex-Rays docs | Hex-Rays Docs Last updated 2 months ago Was this helpful? * * * Discover the core of Hex-Rays guides and manuals, guiding you through IDA features and real-life usage scenarios. [](#getting-started) Getting Started ----------------------------------------- New to IDA? Explore our selection of documentation to guide you through the installation process and jumpstart your reverse engineering journey. [](#our-guides) Our Guides ------------------------------- Delve into detailed guides to discover IDA features and maximize its capabilities. [**Install IDA**](/9.0sp1/getting-started/install-ida) Get your IDA instance up and running on your local machine. [**Manage your license**](/9.0sp1/getting-started/licensing) Check how to handle your license key file to keep IDA subscription active. [**Check basic features**](/9.0sp1/getting-started/basic-usage) Reverse your first binary file and discover the capabilities of disassembly and decompilation. [**User Guide**](/9.0sp1/user-guide) Explore the main IDA interface and features, learn how to customize your experience and take advantage of plugins or utilities. [**Developer Guide**](/9.0sp1/developer-guide) Discover our Developer Kit, featuring the [**IDA C++ SDK**](https://cpp.docs.hex-rays.com/) and [**IDAPython API**](https://python.docs.hex-rays.com/) . Additionally, explore the IDC scripting language. [**Admin Guide**](/9.0sp1/admin-guide) Check how to install and manage Teams and Lumina servers as well as handle floating licenses. --- # What's next? | Hex-Rays Docs [**Enroll in our trainings**](https://hex-rays.io/training) Maksimize your IDA experience with trainigs tailored to all skill levels. [**Watch tutorials**](https://www.youtube.com/@HexRaysSA) Explore the full collection of IDA Pro tutorial videos on our Hex-Rays channel. [**Delve into the User Guide**](/9.0sp1/user-guide) Read in-depth manuals that cover every aspect of IDA. [**Check the blog**](https://hex-rays.io/blog) Learn more about IDA with Igor's tip of the week and explore recent news from Hex-Rays. Last updated 2 months ago Was this helpful? * * * --- # How To Use List Viewers in IDA | Hex-Rays Docs * * * The following commands work in the list viewers: 1\. All usual movement keys: PgUp, PgDn, Home, End and arrows (↑ ↓ → ←). 2\. It is possible to position to a line simply by typing in the desired line number. 3\. It is possible to position on a line by typing in its beginning. In this case the user can use: Backspace key to erase the last character typed in. Ctrl+Enter to find another line with the same prefix. Please note that List Viewer ignores the prefix of a line up to the last backslash (\\\\) or slash (/) if it exists. 4\. Alt+T search for a substring (case-insensitive). Ctrl+T repeat last search. 5\. If the list is not in dialog mode, you can use the following keys: * Enter: jump to the selected item in the last IDA View window * Ctrl+E: edit the current item * Del delete the current item * Ins insert a new item * Ctrl+U refresh information in the window 6\. Quick filtering is available using Ctrl+F. More complex filters can be defined with a right click (only the GUI mode). 7\. The list can be sorted by any column by clicking on it. Please note that maintaining a frequently modified list sorted can be very time consuming, so try not to sort non-modal lists during the initial analysis. (sorting is available only in the GUI mode). 8\. Right-click may show additional functionality for the list viewer. Esc or Enter close modal list viewers. Last updated 1 month ago Was this helpful? --- # Windows | Hex-Rays Docs This submenu allows you to manipulate windows on the screen. You can also: * [Set video mode...](/9.0sp1/user-guide/user-interface/menu-bar/windows#set-video-mode) (text version) * [Invoke external help](/9.0sp1/user-guide/user-interface/menu-bar/windows#invoke-external-help) * [Consult keyboard layout](/9.0sp1/user-guide/user-interface/menu-bar/windows#keyboard-layout) (text version) See also [Menu Bar](/9.0sp1/user-guide/user-interface/menu-bar) submenus. ### [](#set-video-mode) Set Video Mode Copy Action name: SetVideoMode This command changes the current video mode. The list of allowed video modes is kept in the IDATUI.CFG file, the SCREEN\_MODES parameter. Please note that there are two instances in this variable: one for MS-DOS and another for Windows. If you use the MS DOS version, you need to specify the screen mode numbers valid for you video card in SCREEN\_MODES. Otherwise, this command will not work. ### [](#invoke-external-help) Invoke external help Copy Action name: ExternalHelp This command invokes an external help. In the MS Windows version of IDA, it starts WinHelp with the parameter taken from the cursor location. The HELPFILE parameter in IDATUI.CFG/IDAGUI.CFG points to the help file name. ### [](#keyboard-layout) Keyboard layout Copy Action name: KeyboardHelp This command displays the current keyboard layout. You can change the layout in the configuration file Copy IDATUI.CFG (for the text version) IDAGUI.CFG (for the GUI version) This command is available in the text version only. Last updated 2 months ago Was this helpful? * * * ---