Skip to main content

Launch a local Ceramic node

The Ceramic command line interface provides an easy way to start a JS Ceramic node in a local Node.js environment. This is a great way to get started developing with Ceramic before moving to a cloud-hosted node for production use cases.


Installing the CLI requires a console, Node.js v16, and npm v6. Make sure to have these installed on your machine.


While npm v7 is not officially supported, you may still be able to get it to work. You will need to install the node-pre-gyp package globally. This is required until node-webrtc which IPFS depends on is upgraded.

npm install -g node-pre-gyp

Installation and usage

Install the Ceramic CLI

Open your console and install the CLI using npm:

npm install -g @ceramicnetwork/cli

Launch the Ceramic node

Use the ceramic daemon command to start a local JS Ceramic node connected to the Clay Testnet at https://localhost:7007.

ceramic daemon

Configure your network

(Optional) By default, the JS CLI starts a node on the Clay Testnet. If you would like to use a different network, you can specify this using the --network option. View available networks. Note, the CLI can not be used with Mainnet.

Configure a node URL

(Optional) It is possible to use the CLI with a remote Ceramic node over HTTP, instead of a local node. To do this, use the config set command to set the ceramicHost variable to the URL of the node you wish to use.

ceramic config set ceramicHost ''