Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
655360b
docs: rename ADVANCED_README.md to README_ADVANCED.md for lexicograph…
BigLep Jan 16, 2026
43d4e22
docs: add links and system requirements callout
BigLep Jan 16, 2026
dc43663
docs: add command prerequisites to build and start commands
BigLep Jan 16, 2026
bdd1c73
docs: add 'How Defaults Work' section explaining config generation
BigLep Jan 16, 2026
1c80d4d
docs: remove duplicate Manual Cleanup section
BigLep Jan 16, 2026
cce7790
docs: update Run ID format to ISO8601 (YYYY-MM-DDTHH:MM)
BigLep Jan 16, 2026
b999d03
docs: define what a 'step' is when first introduced
BigLep Jan 16, 2026
98a06e3
docs: add links to context keys code location and example
BigLep Jan 16, 2026
427c125
docs: add markdown link formatting for Portainer
BigLep Jan 16, 2026
8d59b01
docs: clarify container architecture in table
BigLep Jan 16, 2026
3d5e01b
docs: fix network diagram and correct Yugabyte architecture
BigLep Jan 16, 2026
e13357f
fix: change Run ID format to condensed ISO8601 (YYYYMMDDTHHMM) for Do…
BigLep Jan 16, 2026
371a6b0
docs: improve repository management section
BigLep Jan 16, 2026
b747314
docs: simplify configuration sharing section
BigLep Jan 16, 2026
22a2f0d
docs: move Reproducible builds to its own heading
BigLep Jan 16, 2026
84b8192
docs: merge Command Flags section with Commands Reference
BigLep Jan 16, 2026
edb143e
docs: restructure lifecycle section
BigLep Jan 16, 2026
f319cff
docs: add inline code comments to Rust examples
BigLep Jan 16, 2026
57c19c3
docs: rename Advanced Topics and remove Last Updated section
BigLep Jan 16, 2026
32701fd
docs: remove redundant sections and improve consistency
BigLep Jan 16, 2026
6a0b1cd
docs: fix relative links to use correct paths
BigLep Jan 16, 2026
b9d4cc1
docs: fix grammar, links, inconsistencies, and heading levels
BigLep Jan 16, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 5 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ This will:
- Start storage provider(s)
- Launch [Portainer UI](https://docs.docksal.io/use-cases/portainer/) for container management

**If you are have troubles**: Use `cargo run -- start`, removing parallelism during start, this may take longer.
**If you have troubles**: Use `cargo run -- start`, removing parallelism during start, this may take longer.

**That's it!** Your local Filecoin network is running.

Expand Down Expand Up @@ -109,7 +109,7 @@ From building Docker images to deploying contracts—everything is automated:
Built with modular steps for easy extension and customization:
- Add custom deployment steps
- Configure multiple PDP service providers
- Control "allowed" SP nodes via `~/.foc-devnet/config.toml`
- Control "allowed" SP nodes via `~/.foc-devnet/config.toml` (see [Configuration System](README_ADVANCED.md#configuration-system))

### 📜 Programmable
Built for scripting and automation:
Expand Down Expand Up @@ -139,12 +139,13 @@ Bundled with Portainer for browser-based Docker management—no terminal wizardr
| **Docker** | Desktop (macOS) or CE (Linux) |
| **tar** | Archive utility (usually pre-installed) |
| **Disk Space** | ~20GB for images and blockchain data |
| **x86 Architecture** | Some dependencies require x86 (Intel) architecture. As a result, ARM-based architectures (including Apple Silicon) may not be supported. See [GitHub Issues](https://github.com/FilOzone/foc-devnet/issues) for current architecture compatibility status. |
Copy link

Copilot AI Jan 16, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The architecture requirement statement is unclear about whether ARM-based architectures are definitively unsupported or potentially unsupported. Consider clarifying by stating either 'are not supported' if this is confirmed, or 'may experience issues' if support status varies by dependency. Also consider adding a brief note about workarounds (e.g., Rosetta 2, Docker x86 emulation) if any exist.

Suggested change
| **x86 Architecture** | Some dependencies require x86 (Intel) architecture. As a result, ARM-based architectures (including Apple Silicon) may not be supported. See [GitHub Issues](https://github.com/FilOzone/foc-devnet/issues) for current architecture compatibility status. |
| **x86 Architecture** | Some dependencies require x86 (Intel) architecture. ARM-based architectures (including Apple Silicon) are not officially supported and may experience issues. Running under x86 emulation (e.g., Rosetta 2 on macOS or Docker x86 emulation) may work but is not guaranteed. See [GitHub Issues](https://github.com/FilOzone/foc-devnet/issues) for current architecture compatibility status. |

Copilot uses AI. Check for mistakes.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| **x86 Architecture** | Some dependencies require x86 (Intel) architecture. As a result, ARM-based architectures (including Apple Silicon) may not be supported. See [GitHub Issues](https://github.com/FilOzone/foc-devnet/issues) for current architecture compatibility status. |
| **x86 Architecture** | Some dependencies require x86 (Intel) architecture. As a result, ARM-based architectures (including Apple Silicon) may not be supported. |

@redpanda-f: can you add a note about why ARM isnt' supported? I thought you said it was because Curio doesn't support it, but I see it does: https://docs.curiostorage.org/installation#arm-based-cpus

If we don't know why it doesn't support it, can you please create a backlog item and we add iink to that backlog item here?


---

## 🛠️ Need More?

See **[ADVANCED_README.md](ADVANCED_README.md)** for comprehensive documentation on:
See **[README_ADVANCED.md](README_ADVANCED.md)** for comprehensive documentation on:
- **All commands reference** (init, build, start, stop, status, version)
- **Configuration system** (config.toml structure, parameters, editing)
- **Complete directory structure** (what's stored where and why)
Expand All @@ -156,7 +157,7 @@ See **[ADVANCED_README.md](ADVANCED_README.md)** for comprehensive documentation
- **Lifecycle overview** (full startup sequence, step implementation)
- **Service Provider examples** (1 SP with 0 authorized, 3 SPs with top 2 authorized, etc.)
- **Troubleshooting guides** (port conflicts, build failures, network issues)
- **Advanced topics** (custom genesis, Lotus API access, contract interaction)
- **Additional user actions** (custom genesis, Lotus API access, contract interaction)

---

Expand Down
Loading