Internxt Drive Desktop for Linux

Compatibility

Internxt Drive Desktop for Linux is currently tested and supported on Ubuntu and Debian with the file managers Nautilus, Nemo, and Dolphin.

The application is also available through the .deb and .rpm packages for these distributions.

We cannot guarantee full compatibility on other Linux distributions or with unsupported file managers, although the app may still work in some environments.

Installation

Internxt Drive is available for Linux in two formats:

.deb Package (Recommended)

Download and install the .deb package for full compatibility:

sudo dpkg -i internxt_2.6.0_amd64.deb

Prerequisites for KDE-based distros

KDE Wallet Configuration Guide

Our application requires the KDE key manager to be properly configured. Depending on your security needs, you can choose between two methods:

• Method 1 (Recommended / Easy): Uses standard symmetric encryption with a master password. It is fast, requires no additional software, and supports automatic unlocking when you log in.
• Method 2 (Advanced / GPG): Uses an OpenPGP key pair via Kleopatra for higher security, though it requires manual entry of your passphrase or PIN upon logging in.

Why Kleopatra? It is the official KDE key manager, offering native integration with KDE Wallet, fewer permission conflicts, and a user-friendly setup wizard compared to generic GPG tools.

For reference, Electron's secure storage API is documented here: safe-storage.

---

Method 1: Standard Setup (Easy & Recommended)

This is the simplest way to set up KDE Wallet and allows seamless automatic unlocking upon system login.

Step 1: Open KDE Wallet Settings

1. Open System Settings.
2. Navigate to KDE Wallet (or search for Wallet in the search bar).
3. Ensure Enable the KDE wallet subsystem is checked.

Step 2: Create a New Wallet

1. Under Automatic Wallet Selection, click Create New Wallet...
2. Enter a name for your wallet (e.g., kdewallet).
3. Select Blowfish encryption (standard password) and click Next.
4. Enter and confirm your Master Password.

   Note: If you set this password to match your Linux user login password, the wallet will unlock automatically when you sign in!

5. Click Finish.

---

Method 2: GPG Key Setup (Advanced)

Use this method if you prefer asymmetric GPG encryption managed via external key managers.

Step 1: Install Kleopatra

Install Kleopatra, which will be used to generate your GPG encryption key:

sudo apt update && sudo apt install kleopatra

Step 2: Generate a GPG Key Pair

1. Open Kleopatra and click New Key Pair (or File > New Key Pair).
2. Select Create a personal OpenPGP key pair.
3. Enter your Name and Email Address.
4. Click Create (or Finish) to complete the setup.

Step 3: Configure KDE Wallet for GPG

1. Open System Settings and search for KDE Wallet.
2. Under Automatic Wallet Selection, click Create New Wallet...
3. Select Use GPG encryption for added security and click Next.
4. Choose the GPG key you created earlier in Kleopatra and click Finish.

---

AppImage

Alternatively, you can use the AppImage format:

chmod +x Internxt-2.6.0.AppImage
./Internxt-2.6.0.AppImage

⚠️ Important Note about AppImage and SSO Login:

Due to technical limitations of the AppImage format, the new SSO login flow is only supported when using Chrome. The .deb version does not have this restriction and remains fully compatible with all browsers.

For the best experience with SSO authentication, we recommend using the .deb package installation method.

Development

Prerequisites

• NVM (Node Version Manager)
• Node.js 24

If working on the FUSE daemon (Go), see packages/fuse-daemon/README.md for Go and linting tool prerequisites.

Install

Clone the repo and install dependencies:

git clone https://github.com/internxt/drive-desktop-linux.git
cd drive-desktop-linux
npm install

Starting Development

Start the app in the dev environment:

npm start

Packaging for Production

To package apps for the local platform:

npm run package

Building the .rpm package requires rpmbuild. On Ubuntu or Debian, install the rpm package before running the packaging command:

sudo apt-get install rpm

Official Release Build (CI Container)

The official release pipeline builds and publishes artifacts inside a pinned container image (Dockerfile.release) to reduce host drift.

Current release flow:

1. Build container image from ubuntu:24.04.
2. Run npm ci and npm run publish inside the container.
3. Upload generated artifacts (.deb, .rpm, .AppImage) plus build metadata.
4. Run smoke tests on the generated .deb without rebuilding it.

Smoke Test Strategy

The release workflow includes a smoke test job that:

1. Downloads the previously built .deb artifact.
2. Installs runtime dependencies for Linux GUI startup checks.
3. Installs the package and verifies /opt/Internxt/internxt exists.
4. Launches the binary in headless mode (xvfb-run) and checks startup.

Login Configuration Using Deeplink

Create a script in the root of the project named enable-sso.sh and add the following content:

#!/bin/bash
export NVM_DIR="$HOME/.nvm"
# Load nvm manually
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
cd "/your-project-path/drive-desktop-linux/"
nvm use 24
npm run start:main -- "$@"

Use the following command to give the script execution permissions:

chmod +x /your-project-location/drive-desktop-linux/enable-sso.sh

Create Linux Handler Protocol File

Use the following command to create the file and add the following content:

vim ~/.local/share/applications/internxt-protocol.desktop

[Desktop Entry]
Type=Application
Name=Internxt Desktop (Dev)
Exec=/your-project-location/drive-desktop-linux/enable-sso.sh %u
Icon=internxt
Terminal=false
MimeType=x-scheme-handler/internxt;

Change the permissions of the newly created file:

chmod 644 ~/.local/share/applications/internxt-protocol.desktop

Register the internxt protocol handler:

xdg-mime default internxt-protocol.desktop x-scheme-handler/internxt

Update the application database:

update-desktop-database ~/.local/share/applications

Check that the internxt protocol is correctly registered:

gio mime x-scheme-handler/internxt

Verify by logging into the application.

Troubleshooting SSO in Development

If opening an internxt:// URL launches the development command but Electron exits with an error like this:

The SUID sandbox helper binary was found, but is not configured correctly.
You need to make sure that node_modules/electron/dist/chrome-sandbox is owned by root and has mode 4755.

Or the dev app does not open at all, it may be that the deeplink registration is working, but Electron is aborting before the main process starts because Chromium's Linux sandbox helper has the wrong owner or permissions.

Confirm the current permissions (in the project root):

ls -l node_modules/electron/dist/chrome-sandbox

Fix them from the project root:

sudo chown root:root node_modules/electron/dist/chrome-sandbox
sudo chmod 4755 node_modules/electron/dist/chrome-sandbox

The expected result is that chrome-sandbox is owned by root and has the setuid bit enabled:

-rwsr-xr-x 1 root root ... node_modules/electron/dist/chrome-sandbox

This may need to be repeated after reinstalling dependencies, because node_modules/electron can be recreated with regular user ownership.