Navin
Back to downloads

Documentation

Installation guide

Follow the steps for your operating system - it takes less than two minutes.

Linux

Three formats: .deb (Ubuntu/Debian), .rpm (Fedora/CentOS/SUSE), AppImage (any distro). Then open a project.

1. Pick a format

  • .deb - Ubuntu, Debian, Linux Mint, Pop!_OS, WSL. Dependencies install with the package.
  • .rpm - Fedora, CentOS, RHEL, Alma, Rocky, openSUSE. Dependencies install with the package.
  • AppImage - Any distribution. Portable - no Navin system installer, but install system dependencies once first.
2. Install - Debian / Ubuntu (.deb)

Dependencies (theme, emoji fonts) are pulled automatically by apt.

sudo apt install ./navin_*_amd64.deb

3. Launch Navin

navin-desktop
2. Install - Fedora / CentOS / openSUSE (.rpm)

Dependencies are pulled automatically by the package manager.

Fedora:

sudo dnf install ./navin-*.x86_64.rpm

CentOS / RHEL / Alma / Rocky:

sudo yum install ./navin-*.x86_64.rpm

openSUSE:

sudo zypper install ./navin-*.x86_64.rpm

3. Launch Navin

navin-desktop
2. Install - AppImage (any distribution)

No system install of Navin. Install dependencies for your distro first, then run the file.

Dependencies (once)

FUSE (to mount the AppImage) + theme + emoji fonts.

Ubuntu / Debian / WSL

sudo apt install libfuse2 adwaita-icon-theme fonts-noto-color-emoji

Fedora

sudo dnf install fuse fuse-libs adwaita-icon-theme google-noto-emoji-color-fonts

CentOS / RHEL / Alma / Rocky

sudo dnf install fuse fuse-libs adwaita-icon-theme google-noto-emoji-fonts

openSUSE

sudo zypper install libfuse2 adwaita-icon-theme google-noto-coloremoji-fonts

Arch / Manjaro

sudo pacman -S fuse2 adwaita-icon-theme noto-fonts-emoji

Launch the AppImage

chmod +x Navin-*.AppImage && ./Navin-*.AppImage

Without FUSE: ./Navin-*.AppImage --appimage-extract-and-run

Windows + WSL (WSLg)

In Ubuntu WSL2: install the .deb, then launch. The window opens through WSLg.

sudo apt install ./navin_*_amd64.deb && navin-desktop

Under WSLg, the title bar stays basic. Navin applies 125% zoom (Ctrl + / Ctrl - to adjust).

4. Open a project

From a terminal, in the project folder (or with a path):

navin .
navin ~/projects/mon-app

Or from the app: + New Agent, then pick the project folder.

Windows
  1. 1

    Download Navin Setup (.exe) or the .msi package from the downloads page.

  2. 2

    Double-click the downloaded file to start the installer.

  3. 3

    Windows SmartScreen may show "Windows protected your PC" - click "More info", then "Run anyway".

  4. 4

    Follow the installer, then launch Navin from the Start menu.

This warning appears because Navin is a new publisher still building reputation with Microsoft, not because of a threat - it fades away on its own as more people install the same signed build.

The navin command, everywhere

Once installed, navin is available in PowerShell, cmd.exe and inside every WSL distribution. Run it from a project folder to open that folder in the editor.

navin .
macOS
  1. 1

    On the downloads page, pick Apple Silicon (M1/M2/M3/M4), Universal (Intel + Apple Silicon), or Intel (x64) for Intel-only Macs.

  2. 2

    Open the .dmg and drag Navin into the Applications folder.

  3. 3

    On first launch, macOS may refuse to open it because "the developer cannot be verified".

  4. 4

    Right-click (or Control-click) the Navin icon, choose "Open", then confirm - this is only needed once.

Alternatively: open System Settings > Privacy & Security, scroll to Security, then click "Open Anyway" next to the Navin message.

Using navin from a terminal

Run navin followed by a folder to open it in the editor, or navin . for the current folder. It works the same in PowerShell, cmd.exe, WSL, Linux and macOS terminals.

navin .
navin ~/projects/my-app
Verify your download (optional)

Every release publishes a SHA256SUMS.txt file next to the binaries. Compare it against your downloaded file before installing.

sha256sum -c SHA256SUMS.txt

Still stuck? Reach us at contact@navinspire.com