docs: add Storage Provider Guides section#862
Conversation
Document the storage provider lifecycle: installing and running a PDP node on Calibration and Mainnet, withdrawing from Filecoin Pay, and advanced Nginx and LXD setups. Wire the section into the sidebar and add a landing-page card.
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
synapse-dev | 9fa121f | Commit Preview URL Branch Preview URL |
Jun 30 2026, 12:26 PM |
|
@truckerfling - IIRC the plan was to keep all SP docs in the filecoin.io docs instead of adding to filecoin.cloud so SPs dont have to float across many documentation sites? |
|
@momack2 yes that is covered here filecoin-project/filecoin-docs#2473. we kept SP docs within docs.filecoin.cloud in case of SPs who enter thru filecoin.cloud and docs.filecoin.cloud. it doesn't detract from the docs.filecoin.io experience to have it on both sites |
LexLuthr
left a comment
LexLuthr
left a comment
There was a problem hiding this comment.
This requires some changes. Some of the assumptions are outdated. CUrio's next release should shorten the Curio+YB section to few lines.
| build-essential hwloc libhwloc-dev libarchive-dev wget ntp python-is-python3 aria2 | ||
| ``` | ||
|
|
||
| ### Install Go 1.23.7 |
There was a problem hiding this comment.
1.26.2+ is required and it will keep changing as Curio releases are cut.
| ### Install Rust | ||
|
|
||
| ```bash | ||
| curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh | ||
| ``` | ||
|
|
||
| When prompted, choose option `1) Proceed with standard installation` (the default, just press Enter). Then load Rust into your shell: | ||
|
|
||
| ```bash | ||
| source $HOME/.cargo/env | ||
| rustc --version | ||
| ``` | ||
|
|
||
| You should see a version such as `rustc 1.86.0 (05f9846f8 2025-03-31)`. |
There was a problem hiding this comment.
With filecoin-project/curio#1311 merged this seems irrelevant.
| --master_flags rpc_bind_addresses=127.0.0.1 \ | ||
| --tserver_flags rpc_bind_addresses=127.0.0.1 |
There was a problem hiding this comment.
Don't need these. advertise_addresssets both.
| ``` | ||
|
|
||
| :::caution[Locale errors on first start] | ||
| If you see locale-related errors, generate the UTF-8 locale and retry: `sudo locale-gen en_US.UTF-8`. |
There was a problem hiding this comment.
This would be very hard for user to debug as it is hidden in YB logs. Just make this into a prerequisite step.
|
|
||
| | Resource | Minimum | | ||
| | --- | --- | | ||
| | RAM | 32 GiB | |
| | --- | --- | | ||
| | RAM | 32 GiB | | ||
| | CPU | 8 cores | | ||
| | Fast storage (NVMe/SSD) | 1 TiB | |
There was a problem hiding this comment.
Fast store is not required for Curio at all. It is only required for Yugabyte
| 3. **Start the database.** | ||
|
|
||
| ```bash | ||
| ./bin/yugabyted start \ |
There was a problem hiding this comment.
This command should be specifying the path to the NVME storage.
6 participants
Closes #861
Adds a new top-level Storage Provider Guides section to docs.filecoin.cloud, after Developer Guides, documenting the provider lifecycle:
Also wires the section into the sidebar and adds a landing-page card.
Source: James (tippyflits) battle-tested PDP provider field guide, rewritten to the docs house style (no emoji, Starlight asides/Steps/Tabs).
Verified against source
chains.js/ ABI (chain 314, Mainnet).getAccountInfoIfSettledsignature and the 4-value return order confirmed against the Filecoin Pay ABI.pdpv0branch andmake calibnet/make buildtargets confirmed against the upstream Makefile.pnpm buildpasses; the link validator reports all internal links valid.Needs maintainer sign-off before merge
These are operator-policy or pinned third-party values taken verbatim from the field guide, not protocol constants:
2.25.1.0-b381.0.833Calibration /0.0833Mainnet),serviceStatus(prod/testing), piece size bounds, and proving period (30).Preview
Sidebar: Storage Provider Guides → Overview, Install & Run a PDP Node, Withdraw from Filecoin Pay, Advanced (Nginx Reverse Proxy, LXD Container Setup).
