Troubleshooting

If you have any issue with the starter, first scan this page, then check our issue queue for similar issues. If nothing found, please create a new issue and/or ask for help on Discord.

MacOS

Error: Failed to download or extract precompiled binary for devnet

If you run localnet start and receive the "Failed to download or extract precompiled binary" error.

Open ~/suibase/workdirs/localnet/suibase.yaml and set Sui binaries version to a previous one:

force_tag: "devnet-v1.24.0"

If it doesn’t work, try setting:

precompiled_bin=false

It will force Suibase to compile Sui binaries from sources.

Another option which someone reported working is:

localnet build

---

Didn't find your issue? Report it to us ->