Stellar CLI failed to install/compile v23.0.0 / v22.8.2: No opt feature

[AuroraLantean]

What version are you using?

Rustc 1.88.0 (6b00bc388 2025-06-23)
OS: Linux Mint 22.1 Xia based on Ubuntu 24.04 noble

What did you do?

Tried to install Stellar CLI according to the Quick Start and Stellar CLI pages:
https://developers.stellar.org/docs/build/smart-contracts/getting-started/setup
https://developers.stellar.org/docs/tools/cli/install-cli

cargo install --locked stellar-cli@22.8.2 --features opt
cargo install --locked stellar-cli@23.0.0 --features opt

What did you expect to see?

Installation successful

What did you see instead?

error: failed to compile `stellar-cli v23.0.0`, 
intermediate artifacts can be found at `/tmp/cargo-installFrHLRj`.
To reuse those artifacts with a future compilation, 
set the environment variable `CARGO_TARGET_DIR` to that path.

Caused by:
  the package 'stellar-cli' does not contain this feature: opt

[AuroraLantean]

Workaround:

1. brew install stellar-cli
2. Download the latest release from https://github.com/stellar/stellar-cli/releases, then move it into /usr/local/bin

Do those methods above also enable future build optimization as mentioned here https://developers.stellar.org/docs/build/smart-contracts/getting-started/hello-world#optimizing-builds ?

[leighmcculloch]

Thanks for reporting!

The instructions appear to be out-of-date, the --features opt is unnecessary. The opt feature is now always installed.

cargo install --locked stellar-cli@23.0.0

However, it's often much faster to install binaries which I see you found also.

Transferring this issue to the docs repo because the issue needs addressing there in documentation.

[ElliotFriend]

Fixed: --features opt no longer appears anywhere in the docs. install-cli.mdx now shows plain cargo install --locked stellar-cli, and setup leads with the binary installs (install.sh / brew). Closing as completed.