IPFS Desktop | IPFS Docs (2024)

IPFS Desktop bundles an IPFS node, file manager, peer manager, and content explorer into a single, easy-to-use application.

Use IPFS Desktop to get acquainted with IPFS without needing to touch the terminal — or, if you're already experienced, use the powerful menubar/taskbar shortcuts alongside the command line to make your IPFS workflow faster.

If you already have an IPFS node on your computer, IPFS Desktop will act as a control panel and file browser for that node. If you don't have a node, it'll install one for you. And either way, IPFS Desktop will automatically check for updates.

IPFS Desktop | IPFS Docs (1)

Files screen Explore screen Peers screen Settings screen Menubar/taskbar
IPFS Desktop | IPFS Docs (2) IPFS Desktop | IPFS Docs (3) IPFS Desktop | IPFS Docs (4) IPFS Desktop | IPFS Docs (5) IPFS Desktop | IPFS Docs (6)

# Feature highlights

  • Start your node at system startup (Mac/Windows) and control it from your OS using the convenient menubar/system tray menu.
  • Quickly import files, folders, and screenshots to IPFS in a variety of convenient ways, including drag-and-drop and (for Windows) right-clicking a file/folder's icon.
  • Easily manage the contents of your node with a familiar file browser that offers quick shortcuts for renaming/moving/pinning files and folders, previewing many common file formats directly in IPFS Desktop, copying content IDs or shareable links to your clipboard, and more.
  • Quick download for CIDs, IPFS paths, and IPNS paths — choose Download... by right-clicking the IPFS icon on your computer's menu bar, paste in a hash, and you're good to go.
  • Visualize your IPFS peers worldwide on a map depicting what nodes you're connected to, where they are, the connections they're using, and more.
  • Explore the "Merkle Forest" of IPFS files with a visualizer that lets you see firsthand how example datasets stored on IPFS — or your own IPFS files — are broken down into content-addressed pieces.
  • OS-wide support for IPFS files and links (on Mac, Windows, and some Linux flavors) automatically hands off links starting with ipfs:// and ipns:// to be opened in IPFS Desktop.
  • CLI Tutor Mode helps you learn IPFS commands as you go.

# Install instructions

To install IPFS Desktop, follow the specific instructions for your operating system. IPFS Desktop is built using the Electron framework (opens new window), so the application should work wherever Electron works.

Windows macOS Ubuntu

Or, if you'd rather use a package manager, check this list of third-party packages maintained by the IPFS community.

# Windows

  1. Go to the IPFS Desktop downloads page (opens new window)

  2. Find the link ending in .exe for the latest version of IPFS Desktop:

    IPFS Desktop | IPFS Docs (10)

  3. Run the .exe file to start the installation.

  4. Select whether you want to install the application for just yourself or all users on the computer. Click Next:

    IPFS Desktop | IPFS Docs (11)

  5. Select the install location for the application. The default location is usually fine. Click Next:

    IPFS Desktop | IPFS Docs (12)

  6. Wait for the installation to finish and click Finish:

    IPFS Desktop | IPFS Docs (13)

  7. You can now find an IPFS icon in the status bar:

    IPFS Desktop | IPFS Docs (14)

The IPFS Desktop application has finished installing. Now, add your site.

# macOS

  1. Download the latest available .dmg file from the ipfs/ipfs-desktop releases page (opens new window)

    IPFS Desktop | IPFS Docs (15)

  2. Open the ipfs-desktop.dmg file.

  3. Drag the IPFS icon into the Applications folder:

    IPFS Desktop | IPFS Docs (16)

  4. Open your Applications folder and open the IPFS Desktop application.

  5. You may get a warning saying IPFS Desktop.app can't be opened. Click Show in Finder:

    IPFS Desktop | IPFS Docs (17)

  6. Find IPFS Desktop.app in your Applications folder.

  7. Hold down the control key, click IPFS Desktop.app, and click Open:

    IPFS Desktop | IPFS Docs (18)

  8. Click Open in the new window:

    IPFS Desktop | IPFS Docs (19)

  9. You can now find an IPFS icon in the status bar:

    IPFS Desktop | IPFS Docs (20)

The IPFS Desktop application has finished installing. Now, add your site.

# Ubuntu

While these instructions are specific to Ubuntu, they will likely work with most Ubuntu-related Linux distributions. For non-Ubuntu Linux distributions, check out the IPFS Desktop GitHub repository (opens new window) for install instructions.

# Install with .deb

  1. Download the latest .deb installer from the IPFS Desktop GitHub repository (opens new window).

  2. Double click to install the package with Ubuntu Software, or move into where you downloaded the installer and install from the command-line:

    sudo dpkg -i ./ipfs-desktop-[version]-amd64.deb

    Replace [version] with the version number of the IPFS package you just downloaded.

# Install using AppImage

WARNING

When installing IPFS Desktop using an AppImage executable, you will not have access to the command-line ipfs commands. This limitation is due to how AppImages work and how they containerize their processes.

If you are certain that you do not need to use the command-line ipfs commands, then go ahead and install the AppImage. Otherwise, consider using the deb installer ↑

  1. Download the latest .AppImage package from the IPFS Desktop GitHub repository (opens new window).

  2. Move into where you downloaded the .AppImage file, and make it executable:

    cd Downloadschmod a+x ./ipfs-desktop-linux.AppImage
  3. Open the .AppImage by calling ./ipfs-desktop-linux.AppImage from the command-line:

    ./ipfs-desktop-linux.AppImage

    You can also run the .AppImage file by double-clicking on it in your file manager.

# Package Managers

Package Manager Command
Homebrew (opens new window) brew install ipfs --cask
Chocolatey (opens new window) choco install ipfs-desktop
Scoop (opens new window) maintained by @NatoBoram (opens new window) scoop bucket add extras && scoop install ipfs-desktop
AUR (opens new window) maintained by @alexhenrie (opens new window) ipfs-desktop

# Next steps

Now that you've got IPFS Desktop installed, you can start sharing files and interacting with other nodes on the network! Check out how to host a website using IPFS →

IPFS Desktop | IPFS Docs (2024)
Top Articles
Latest Posts
Article information

Author: Rev. Leonie Wyman

Last Updated:

Views: 6180

Rating: 4.9 / 5 (59 voted)

Reviews: 82% of readers found this page helpful

Author information

Name: Rev. Leonie Wyman

Birthday: 1993-07-01

Address: Suite 763 6272 Lang Bypass, New Xochitlport, VT 72704-3308

Phone: +22014484519944

Job: Banking Officer

Hobby: Sailing, Gaming, Basketball, Calligraphy, Mycology, Astronomy, Juggling

Introduction: My name is Rev. Leonie Wyman, I am a colorful, tasty, splendid, fair, witty, gorgeous, splendid person who loves writing and wants to share my knowledge and understanding with you.