Installation

Installation

GhostlyShare publishes separate desktop and CLI packages. Install the desktop app when you want the graphical tray workflow, app detection, QR code view, password settings, link lifetime settings, and custom-domain setup screens. Install the CLI when you want the ghs terminal command for scripts, servers, CI helpers, or SSH sessions.

Desktop and CLI packages can be installed independently. Install both when you want the graphical app and the terminal command on the same system.

Package Overview

Platform	Package	Installs	Use when
Windows	Microsoft Store	Desktop app	You want the easiest signed Windows desktop install and Store-managed updates.
Windows	GhostlyShareSetup_win-x64.zip	Desktop setup package	You want a direct desktop installer download outside the Store.
Windows	GhostlyShareCLI_win-x64.zip	ghs.exe	You want the command-line tool without the desktop app.
Ubuntu, Debian, Kali, Linux Mint, Pop!_OS	ghostlyshare-x86_64.deb	ghostlyshare	You want the Linux desktop app on a Debian-based distribution.
Ubuntu, Debian, Kali, Linux Mint, Pop!_OS	ghostlyshare-cli-x86_64.deb	ghs	You want the Linux CLI on a Debian-based distribution.
Arch Linux	ghostlyshare-x86_64.pkg.tar.zst	ghostlyshare	You want the desktop app on Arch Linux.
Arch Linux	ghostlyshare-cli-x86_64.pkg.tar.zst	ghs	You want the CLI on Arch Linux.
Fedora, openSUSE, RHEL, Rocky Linux, AlmaLinux	ghostlyshare-x86_64.rpm	ghostlyshare	You want the desktop app on an RPM-based distribution.
Fedora, openSUSE, RHEL, Rocky Linux, AlmaLinux	ghostlyshare-cli-x86_64.rpm	ghs	You want the CLI on an RPM-based distribution.
RPM-based Linux	RPM-GPG-KEY-GhostlyShare	RPM trust key	You want to verify and install signed RPM packages.

Windows Desktop

Prefer the Microsoft Store for the easiest desktop install:

Install GhostlyShare from Microsoft Store

The Store package is delivered and updated by Microsoft.

If you prefer a direct download, use the latest setup ZIP:

Download GhostlyShareSetup_win-x64.zip

Extract the ZIP and run the setup executable inside it.

Windows CLI

Download the latest Windows CLI ZIP:

Download GhostlyShareCLI_win-x64.zip

Extract the ZIP and run:

.\ghs.exe --help

The Windows CLI ZIP contains a direct executable download. Windows may show a SmartScreen or Microsoft Defender warning. Only run it after verifying that it came from the official GhostlyShare release page.

Ubuntu, Debian, Kali, Linux Mint, Pop!_OS

Download and install both desktop and CLI packages:

mkdir -p ~/Downloads/ghostlyshare
cd ~/Downloads/ghostlyshare

wget https://github.com/Nix1983/GhostlyShare-Releases/releases/latest/download/ghostlyshare-x86_64.deb
wget https://github.com/Nix1983/GhostlyShare-Releases/releases/latest/download/ghostlyshare-cli-x86_64.deb

sudo apt install ./ghostlyshare-x86_64.deb ./ghostlyshare-cli-x86_64.deb

Install only the desktop app:

sudo apt install ./ghostlyshare-x86_64.deb

Install only the CLI:

sudo apt install ./ghostlyshare-cli-x86_64.deb

Use apt install ./package.deb instead of plain dpkg -i whenever possible. apt installs the package and resolves dependencies; dpkg -i may leave dependencies missing until you repair them manually.

Fedora

Download the RPM signing key and both RPM packages:

mkdir -p ~/Downloads/ghostlyshare
cd ~/Downloads/ghostlyshare

wget https://github.com/Nix1983/GhostlyShare-Releases/releases/latest/download/RPM-GPG-KEY-GhostlyShare
wget https://github.com/Nix1983/GhostlyShare-Releases/releases/latest/download/ghostlyshare-x86_64.rpm
wget https://github.com/Nix1983/GhostlyShare-Releases/releases/latest/download/ghostlyshare-cli-x86_64.rpm

Import the public key and install both packages:

sudo rpm --import RPM-GPG-KEY-GhostlyShare
sudo dnf install ./ghostlyshare-x86_64.rpm ./ghostlyshare-cli-x86_64.rpm

Install only the desktop app:

sudo dnf install ./ghostlyshare-x86_64.rpm

Install only the CLI:

sudo dnf install ./ghostlyshare-cli-x86_64.rpm

openSUSE

Download the RPM signing key and both RPM packages:

mkdir -p ~/Downloads/ghostlyshare
cd ~/Downloads/ghostlyshare

wget https://github.com/Nix1983/GhostlyShare-Releases/releases/latest/download/RPM-GPG-KEY-GhostlyShare
wget https://github.com/Nix1983/GhostlyShare-Releases/releases/latest/download/ghostlyshare-x86_64.rpm
wget https://github.com/Nix1983/GhostlyShare-Releases/releases/latest/download/ghostlyshare-cli-x86_64.rpm

Import the public key and install both packages:

sudo rpm --import RPM-GPG-KEY-GhostlyShare
sudo zypper install ./ghostlyshare-x86_64.rpm ./ghostlyshare-cli-x86_64.rpm

Install only the desktop app:

sudo zypper install ./ghostlyshare-x86_64.rpm

Install only the CLI:

sudo zypper install ./ghostlyshare-cli-x86_64.rpm

RHEL, Rocky Linux, AlmaLinux

Download the RPM signing key and both RPM packages:

mkdir -p ~/Downloads/ghostlyshare
cd ~/Downloads/ghostlyshare

wget https://github.com/Nix1983/GhostlyShare-Releases/releases/latest/download/RPM-GPG-KEY-GhostlyShare
wget https://github.com/Nix1983/GhostlyShare-Releases/releases/latest/download/ghostlyshare-x86_64.rpm
wget https://github.com/Nix1983/GhostlyShare-Releases/releases/latest/download/ghostlyshare-cli-x86_64.rpm

Import the public key and install both packages:

sudo rpm --import RPM-GPG-KEY-GhostlyShare
sudo dnf install ./ghostlyshare-x86_64.rpm ./ghostlyshare-cli-x86_64.rpm

Install only the desktop app:

sudo dnf install ./ghostlyshare-x86_64.rpm

Install only the CLI:

sudo dnf install ./ghostlyshare-cli-x86_64.rpm

Arch Linux

Download and install both desktop and CLI packages:

mkdir -p ~/Downloads/ghostlyshare
cd ~/Downloads/ghostlyshare

curl -LO https://github.com/Nix1983/GhostlyShare-Releases/releases/latest/download/ghostlyshare-x86_64.pkg.tar.zst
curl -LO https://github.com/Nix1983/GhostlyShare-Releases/releases/latest/download/ghostlyshare-cli-x86_64.pkg.tar.zst

sudo pacman -U ./ghostlyshare-x86_64.pkg.tar.zst ./ghostlyshare-cli-x86_64.pkg.tar.zst

Install only the desktop app:

sudo pacman -U ./ghostlyshare-x86_64.pkg.tar.zst

Install only the CLI:

sudo pacman -U ./ghostlyshare-cli-x86_64.pkg.tar.zst

Verify Downloads

Download GhostlyShare only from the Microsoft Store or the official latest GitHub release:

Latest GhostlyShare release

When SHA256 checksums are shown in the release notes, compare the published checksum with the file you downloaded before installing.

Linux example:

sha256sum ghostlyshare-x86_64.rpm
sha256sum ghostlyshare-cli-x86_64.rpm

Windows example:

Get-FileHash .\GhostlyShareSetup_win-x64.zip -Algorithm SHA256
Get-FileHash .\GhostlyShareCLI_win-x64.zip -Algorithm SHA256

Verify RPM Signatures

RPM packages are signed. Import the public key first:

sudo rpm --import RPM-GPG-KEY-GhostlyShare

Then check the package signatures:

rpmkeys --checksig --verbose ./ghostlyshare-x86_64.rpm
rpmkeys --checksig --verbose ./ghostlyshare-cli-x86_64.rpm

The output should report an OK signature after the key is imported. A SHA256 checksum only proves file integrity against a published checksum. The RPM signature also confirms that the package was signed with the GhostlyShare release key.

Start After Installation

Start the desktop app from your application launcher, or run:

ghostlyshare

Run the CLI with:

ghs --help

Update

Download the newest package from the latest release and install it over the existing version. Desktop and CLI packages are separate, so update the package or packages you use.

For RPM packages, import the latest RPM-GPG-KEY-GhostlyShare before installing or updating if you have not already imported it.

Uninstall

For uninstall commands and local cleanup notes, see Cleanup and Uninstall.