Ctrlk
BasicsStorage providersNodesNetworksSmart contractsReference
For the complete documentation index, see llms.txt. This page is also available as Markdown.
ChatGPT

Install & Run PDP

This guide walks you through setting up a PDP-enabled Filecoin Storage Provider using Lotus, YugabyteDB, and Curio

🚀 Prerequisites

Note: This guide is written specifically for Ubuntu 22.04. If you are using a different Linux distribution, refer to the relevant documentation for package installation and compatibility.

Before starting, make sure you have a user with sudo privileges. This section prepares your system for the PDP stack.

⚙️ Hardware requirements

  • RAM: 32 GiB+

  • CPU: 8 Core+

  • Storage:

    • 1 TiB Fast storage (NVMe/SSD)

    • 10 TiB Long-term storage (HDD)

  • GPU: Not required

  • Connectivity: Public HTTPS endpoint (domain)

🧰 System Package Installation

sudo apt update && sudo apt upgrade -y && sudo apt install -y \
  mesa-opencl-icd ocl-icd-opencl-dev gcc git jq pkg-config curl clang \
  build-essential hwloc libhwloc-dev libarchive-dev wget ntp python-is-python3 aria2

🔨 Install Go (v1.24.0)

You should see something like: go version go1.24.0 linux/amd64

🔧 Install Rust

When prompted, choose the option 1) Proceed with standard installation (default — just press Enter).

You should see something like: rustc 1.86.0 (05f9846f8 2025-03-31)

⛓️ Installing and Running Lotus

🧠 Lotus is your gateway to the Filecoin network. It syncs the chain, manages wallets, and is required for Curio to interact with your node.

Cover

Lotus Documentation

Cover

Lotus Support Channels

🔧 Build Lotus Daemon

Clone and check out Lotus:

Build and Install for Mainnet

Build and Install for Calibration

You should see something like: lotus version 1.36.0+calibnet+git.154c0c3a4

📦 Import a Snapshot and Start the Daemon

Download the Snapshot

Mainnet:

Calibration:

Import and Start the Daemon

If you encounter errors related to EnableEthRPC or EnableIndexer, run the following command and restart Lotus

Monitor Sync Progress

To monitor continuously:

Monitor Logs

🐘 Running YugabyteDB

🧠 Curio uses YugabyteDB to store metadata about deals, sealing operations, and PDP submissions.

Cover

Yugabyte Documentation

Cover

Yugabyte Support Channels

🛠 Set ulimit configuration

Before starting Yugabyte, you must increase the default ulimit values to ensure system limits do not interfere with the database.

To do this:

🔁 Persist new limits across reboots

Add these lines to /etc/security/limits.conf:

This ensures the increased limits are automatically applied to future sessions.

⚡ Apply limit immediately (for current shell only)

Verify:

This should output 1048576.

⚙️ Install Yugabyte

🚀 Start the DB

If you encounter locale-related errors when starting Yugabyte for the first time, run:

Visit http://127.0.0.1:15433 to confirm successful installation. This is the YugabyteDB web UI — it should display the dashboard if the service is running correctly and all nodes are healthy.

You can also check your Yugabyte cluster details directly in the CLI with:

🧱 Installing and Configuring Curio

🧠 Curio is the core PDP client that coordinates sealing, interacts with Lotus and submits PDP proofs.

Cover

Curio Documentation

Cover

Curio Support Channels

⚙️ System Configuration

Before you proceed with the installation, you should increase the UDP buffer size:

To make this change persistent across reboots:

🔬 Build Curio

Clone the repository and switch to the latest branch:

Curio is compiled for a specific Filecoin network at build time. Choose the appropriate build command below.

Mainnet

Calibration

This step will take a few minutes to complete.

✅ Install and Verify Curio

Run the following to install the compiled binary:

This will place curio in /usr/local/bin

Verify the installation:

Expected example output:

🔧 Guided Setup

Curio provides a utility to help you set up a new miner interactively. Run the following command:

1️⃣ Select Curio Installation Type

Use the arrow keys to navigate the guided setup menu and select "Setup non-Storage Provider cluster".

2️⃣ Enter Your YugabyteDB Connection Details

If you used the default installation steps from this guide, the following values should work:

  • Host: 127.0.0.1

  • Port: 5433

  • Username: yugabyte

  • Password: yugabyte

  • Database: yugabyte

You can verify these settings by running the following command from the Yugabyte directory:

After selecting "Continue to connect and update schema", Curio will automatically create the required tables and schema in the database.

3️⃣ Telemetry (Optional)

You'll be asked whether to share anonymised or signed telemetry with the Curio team to help improve the software.

Select your preference and continue.

4️⃣ Save Database Configuration

At the final step of the guided setup, you'll be prompted to choose where to save your database configuration file.

Use the arrow keys to select a location. A common default is:

Once selected, setup will complete, and the miner configuration will be stored.

5️⃣ Launch the Curio Web GUI

To explore the Curio interface visually, start the GUI layer:

Then, open your browser and go to:

This will launch the Curio web GUI locally.

🧪 Enabling PDP

🧠 This section enables Proof of Data Possession (PDP) on your storage provider node using Curio. PDP is the verification layer used by the Filecoin Warm Storage Service (FWSS) within Filecoin Onchain Cloud. These steps guide you through running a standalone PDP service using Curio and pdptool.

Cover

PDP Support Channels

📦 Attach Storage Locations

With Curio running with the GUI layer:

Run the following commands in your Curio CLI to attach storage paths:

Your fast-storage path should point to high-performance storage media such as NVMe or SSD

🔧 Add a PDP Configuration Layer

Browse to the Configurations page of the Curio GUI.

Create a new layer named pdp and enable the following under Subsystems:

You may find it helpful to search for the setting names in your browser.

  • ✅ EnableParkPiece

  • ✅ EnablePDP

  • ✅ EnableCommP

  • ✅ EnableMoveStorage

  • ✅ NoUnsealedDecode

In the HTTP section:

  • ✅ Enable: true

  • 🌐 DomainName: your domain (e.g., pdp.mydomain.com)

  • 📡 ListenAddress: 0.0.0.0:443

Tip: You must point your domain's A record to your server's public IP address for Let's Encrypt to issue a certificate.

💰 Import your Filecoin Wallet Private Key:

There are several ways to obtain private keys for Ethereum addresses. In this guide, we will use a new delegated FIL wallet address.

Create a new delegated wallet:

You can display your Lotus wallets at any time by running:

Export & convert your new delegated wallet address private key:

Browse to the PDP page of the Curio GUI and in the Owner Address section:

  • Select Import Key

  • Copy the previously generated private wallet key into the Private Key (Hex) field.

  • Select Import Key

Your 0x wallet address - the delegated Ethereum address derived from your Filecoin delegated wallet private key - will be added to the Owner Address section of the Curio PDP page.

Make sure to send a small amount of FIL or tFIL (testnet FIL) to your 0x wallet - we recommend 8 FIL for Mainnet & 5 tFIL for Calibration to ensure uninterrupted PDP operation during initial setup and testing. Calibration test FIL faucet information.

Important: Secure your private key material. Don't expose or store it in plain text without protection.

🚀 Restart and Verify

Restart Curio with both layers:

If you encounter errors related to EnableEthRPC or EnableIndexer, run the following command and restart Lotus

If you encounter errors binding to port 443 when starting Curio with the pdp configuration layer, run:

🔗 Test Connectivity

Browse to your PDP node's domain name in your browser. You should see the following message in your browser window:

🗳️ Register Your PDP Calibration Node With The Filecoin Warm Storage Service

Browse to the PDP page of the Curio GUI and locate the Filecoin Service Registry section.

STEP 1 — Update Details

Select Update Details and fill in:

Field
Notes

Name

≤ 128 chars

Description

≤ 256 chars

Select Update to submit your node details to the on-chain FWSS contract.

You can review the names and descriptions of other FWSS providers at https://filecoin.cloud/service-providers.

STEP 2 — Update PDP Offering

Select Update PDP Offering and set:

Field
Recommended value

Minimum Piece Size (Bytes)

1048576

Maximum Piece Size (Bytes)

1073741824

Storage Price (USDFC per TiB per day)

0.833

Minimum Proving Period (Epochs)

30

Location

e.g. C=US;ST=California;L=San Francisco (only C= is required)

Then use Add Capability to add the following key/value pairs:

Key
Value

serviceStatus

prod

capacityTib

your available storage capacity in TiB

Select Update PDP to submit your offering to the on-chain FWSS contract.

You can revisit Update PDP Offering at any time to change the Service URL, piece size range, IPNI toggles, price, proving period, location, or custom capabilities.

🎉 You're Done!

You've successfully launched a PDP-enabled Filecoin Storage Provider stack. Your system is now:

  • ✅ Syncing with the Filecoin network via Lotus

  • ✅ Recording deal and piece metadata in YugabyteDB

  • ✅ Operating Curio to manage sealing and coordination

  • ✅ Enabled Proof of Data Possession (PDP)

  • ✅ Connected to your PDP-enabled storage provider

  • ✅ Registered with the Filecoin Warm Storage Service onchain contract

🔜 Next Steps

PreviousAbout PDPNextNetworks

Last updated