> For the complete documentation index, see [llms.txt](https://docs.filecoin.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.filecoin.io/provide-storage/pdp/install-and-run-pdp.md).
# Install & Run PDP
## ๐ Prerequisites
{% hint style="warning" %}
**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.
{% endhint %}
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
```sh
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
```
***
### :hammer: Install Go (v1.24.0)
```sh
sudo rm -rf /usr/local/go
wget https://go.dev/dl/go1.24.0.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.24.0.linux-amd64.tar.gz
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc
go version
```
{% hint style="success" %}
You should see something like: `go version go1.24.0 linux/amd64`
{% endhint %}
***
### :wrench: Install Rust
```sh
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
```
{% hint style="info" %}
When prompted, choose the option 1) Proceed with standard installation (default โ just press Enter).
{% endhint %}
```sh
source $HOME/.cargo/env
rustc --version
```
{% hint style="success" %}
You should see something like: `rustc 1.86.0 (05f9846f8 2025-03-31)`
{% endhint %}
***
## โ๏ธ 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.
### ๐ Set ulimit configuration
{% hint style="warning" %}
Before starting Yugabyte, you must increase the default `ulimit` values to ensure system limits do not interfere with the database.
{% endhint %}
To do this:
#### ๐ **Persist new limits across reboots**
Add these lines to `/etc/security/limits.conf`:
```sh
echo "$(whoami) soft nofile 1048576" | sudo tee -a /etc/security/limits.conf
echo "$(whoami) hard nofile 1048576" | sudo tee -a /etc/security/limits.conf
```
This ensures the increased limits are automatically applied to future sessions.
#### โก **Apply limit immediately (for current shell only)**
```sh
ulimit -n 1048576
```
Verify:
```sh
ulimit -n
```
{% hint style="success" %}
This should output `1048576`.
{% endhint %}
### โ๏ธ Install Yugabyte
```sh
wget https://software.yugabyte.com/releases/2.25.1.0/yugabyte-2.25.1.0-b381-linux-x86_64.tar.gz
tar xvfz yugabyte-2.25.1.0-b381-linux-x86_64.tar.gz
cd yugabyte-2.25.1.0
./bin/post_install.sh
```
### ๐ Start the DB
```sh
./bin/yugabyted start \
--advertise_address 127.0.0.1 \
--master_flags rpc_bind_addresses=127.0.0.1 \
--tserver_flags rpc_bind_addresses=127.0.0.1
```
{% hint style="warning" %}
If you encounter locale-related errors when starting Yugabyte for the first time, run:
{% endhint %}
```sh
sudo locale-gen en_US.UTF-8
```
{% hint style="success" %}
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.
{% endhint %}
{% hint style="info" %}
You can also check your Yugabyte cluster details directly in the CLI with:
{% endhint %}
```sh
./bin/yugabyted status
```
***
## ๐งฑ Installing and Configuring Curio
๐ง Curio is the core PDP client that coordinates sealing, interacts with Lotus and submits PDP proofs.
### โ๏ธ System Configuration
Before you proceed with the installation, you should increase the UDP buffer size:
```sh
sudo sysctl -w net.core.rmem_max=2097152
sudo sysctl -w net.core.rmem_default=2097152
```
To make this change persistent across reboots:
```sh
echo 'net.core.rmem_max=2097152' | sudo tee -a /etc/sysctl.conf
echo 'net.core.rmem_default=2097152' | sudo tee -a /etc/sysctl.conf
```
### ๐ฌ Build Curio
Clone the repository and switch to the latest branch:
```sh
git clone https://github.com/filecoin-project/curio.git
cd curio
git checkout $(curl -s https://api.github.com/repos/filecoin-project/curio/releases/latest | jq -r .tag_name)
```
{% hint style="info" %}
Curio is compiled for a specific Filecoin network at build time. Choose the appropriate build command below.
{% endhint %}
Mainnet
```sh
make clean build
```
Calibration
```sh
make clean calibnet
```
{% hint style="info" %}
This step will take a few minutes to complete.
{% endhint %}
### โ Install and Verify Curio
Run the following to install the compiled binary:
```sh
sudo make install
```
This will place curio in `/usr/local/bin`
Verify the installation:
```sh
curio --version
```
Expected example output:
```sh
curio version 1.24.4+calibnet+git_f954c0a_2025-04-06T15:46:32-04:00
```
***
### ๐ง Guided Setup
Curio provides a utility to help you set up a new miner interactively. Run the following command:
```sh
curio guided-setup
```
#### 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:
```sh
./bin/yugabyted status
```
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:
```sh
/home/your-username/curio.env
```
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:
```sh
curio run --layers=gui
```
Then, open your browser and go to:
```sh
http://127.0.0.1:4701
```
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)](https://docs.filecoin.cloud/core-concepts/fwss-overview) within [Filecoin Onchain Cloud](/build-on-filecoin/filecoin-onchain-cloud.md). These steps guide you through running a standalone PDP service using Curio and pdptool.
### ๐ฆ Attach Storage Locations
With Curio running with the GUI layer:
```sh
curio run --layers=gui
```
Run the following commands in your Curio CLI to attach storage paths:
```sh
curio cli storage attach --init --seal /fast-storage/path
curio cli storage attach --init --store /long-term-storage/path
```
{% hint style="info" %}
Your fast-storage path should point to high-performance storage media such as NVMe or SSD
{% endhint %}
***
### ๐ง 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:
{% hint style="info" %}
You may find it helpful to search for the setting names in your browser.
{% endhint %}
* โ `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`
{% hint style="info" %}
**Tip:** You must point your domain's A record to your server's public IP address for Let's Encrypt to issue a certificate.
{% endhint %}
***
### ๐ฐ Import your Filecoin Wallet Private Key:
{% hint style="warning" %}
There are several ways to obtain private keys for Ethereum addresses. In this guide, we will use a new delegated FIL wallet address.
{% endhint %}
Create a new delegated wallet:
```sh
lotus wallet new delegated
```
```sh
# Example output:
t410fuo4dghaeiqzokiqnxruzdr6e3cjktnxprrc56bi
```
{% hint style="info" %}
You can display your Lotus wallets at any time by running:
{% endhint %}
```sh
lotus wallet list
```
Export & convert your new delegated wallet address private key:
```sh
lotus wallet export | xxd -r -p | jq -r '.PrivateKey' | base64 -d | xxd -p -c 32
```
```sh
# Example output:
d4c2e3f9a716bb0e47fa91b2cf4a29870be3c5982fd6eafed71e8ac3f9c0b127
```
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**
{% hint style="success" %}
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.
{% endhint %}
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](/build-on-filecoin/developing-contracts/get-test-tokens.md).
{% hint style="warning" %}
**Important:** Secure your private key material. Don't expose or store it in plain text without protection.
{% endhint %}
***
### ๐ Restart and Verify
Restart Curio with both layers:
```sh
curio run --layers=gui,pdp
```
{% hint style="info" %}
If you encounter errors related to `EnableEthRPC` or `EnableIndexer`, run the following command and restart Lotus
{% endhint %}
```sh
sed -i 's/^\( *\)#*EnableEthRPC = .*/\1EnableEthRPC = true/; s/^\( *\)#*EnableIndexer = .*/\1EnableIndexer = true/' ~/.lotus/config.toml
```
{% hint style="info" %}
If you encounter errors binding to port 443 when starting Curio with the pdp configuration layer, run:
{% endhint %}
```sh
sudo setcap 'cap_net_bind_service=+ep' /usr/local/bin/curio
```
***
### ๐ Test Connectivity
Browse to your PDP node's domain name in your browser. You should see the following message in your browser window:
```
Hello, World!
-Curio
```
***
### ๐ณ๏ธ 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.
{% hint style="info" %}
You can review the names and descriptions of other FWSS providers at .
{% endhint %}
#### 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
* :link: Explore FWSS & PDP tools & resources at [https://www.filecoin.services](https://www.filecoin.services/)
* ๐ฌ Join the community - Filecoin Slack - [#fil-pdp](https://filecoinproject.slack.com/archives/C0717TGU7V2)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.filecoin.io/provide-storage/pdp/install-and-run-pdp.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.