LogoLogo
  • Pear by Holepunch
  • Pear runtime
    • Command-Line-Interface (CLI)
    • Application-Programming-Interface (API)
    • Application Configuration
    • Troubleshooting Applications
    • Frequently Asked Questions
  • Bare reference
    • Overview
    • Application-Programming-Interface (API)
    • Node.js Compatibility with Bare
    • Bare Modules
    • Troubleshooting with Bare
  • Guides
    • Getting Started
    • Starting a Pear Desktop Project
    • Making a Pear Desktop Application
    • Starting a Pear Terminal Project
    • Making a Pear Terminal Application
    • Sharing a Pear Application
    • Marking a Release
    • Making a Bare Mobile Application
    • Debugging a Pear Terminal Application
    • Creating a Pear Init Template
    • Best Practices
  • Building blocks
    • Hypercore
    • Hyperbee
    • Hyperdrive
    • Autobase
    • HyperDHT
    • Hyperswarm
  • How-tos
    • Connect two peers
    • Connect many peers
    • Replicate & persist
    • Manage multiple Hypercores
    • Share append-only databases
    • Create a p2p filesystem
  • Helpers
    • Corestore
    • Localdrive
    • Mirrordrive
    • Secretstream
    • Compact encoding
    • Protomux
  • Tools
    • Hypershell
    • Hypertele
    • Hyperbeam
    • Hyperssh
    • Drives
  • Apps
    • Keet
  • Examples
    • Bare on Mobile
    • React App using Pear
Powered by GitBook

Copyright © 2024 - 2025 Holepunch, S.A. de C.V. All rights reserved.

On this page
  • Requirements
  • Setup
  • Next
  1. Guides

Getting Started

Last updated 3 days ago

Pear Runtime can be installed via .

Since npm (or equivalent package manager) is needed to install application dependencies this guide will walk through installing pear with npm.

Build with Pear - Episode 01: Developing with Pear

Requirements

Pear runs on Windows, Mac and Linux.

Linux requires the libatomic library which can be installed using:

Debian/Ubuntu:

sudo apt install libatomic1

RHEL/CentOS:

sudo yum install libatomic

Fedora:

sudo dnf install libatomic

Alpine Linux:

sudo apk add libatomic

Arch Linux:

sudo pacman -S libatomic_ops

The npm package manager can also be used to install application dependencies later on.

The Pear Runtime does not rely on node, node is only needed to install and run the npm package manager.

Setup

To install Pear run the following command:

npm i -g pear

To complete the setup, run the pear command.

pear

If not, the first run of pear will fetch the platform from peers, after which running pear again should output help information.

To check that Pear is fully working, try the following command:

pear run pear://keet

Next

The pear CLI can be installed from , which comes with .

On MacOS and Linux, we recommend installing node using

On Windows we recommend installing node with .

If a Pear application, such as , is already installed then the Pear platform is already available. In this case, running pear should show help output.

Pear loads applications from peers, so this command should open whether or not it was downloaded and installed beforehand.

npm
node
nvm
nvs
Keet
Keet
Starting a Pear Desktop Project
Starting a Pear Terminal Project
npm