rust-mirror

Prepare Rust toolchain snapshots for offline development and static hosting, including Nexus Repository Raw hosted repositories.

Start with the complete user guide, then use the command/configuration reference for exact options and defaults. The guide explains preparation, Nexus publication, activation and client updates as separate steps.

Current state

CLI and reusable library for selected modern Rustup distributions. Choose named toolchain versions/channels, host platforms, profiles, components and compilation targets; preview a metadata-only plan, then download that frozen selection for static hosting. Interrupted selected downloads can resume verified progress. Combine completed selections into an immutable multi-version mirror. Publish a verified generation with the native publish command; Python is needed only for the optional reference helper and qualification scripts. Rustup remains the installer. See the selection guide. Use one-shot sync and runnable demos to run the workflow with one command. Complete Rustup endpoints and channel promotion cover bootstrap, self-update and explicit client-generation changes. The release record states exact qualification and remaining limits.

Rust/Cargo 1.90+ is required to build. Install a published version with cargo install rust-mirror --version 0.1.0 --locked, or build the source below. Check the release notes for availability and exact evidence.

cargo build --locked
# Use target/debug/rust-mirror (Windows: target/debug/rust-mirror.exe).
rust-mirror init --config mirror.toml
rust-mirror list --toolchain 1.90.0 --host x86_64-unknown-linux-gnu
# Edit mirror.toml before planning; linux-dev is one of the example selections.
rust-mirror plan --config mirror.toml --selection linux-dev --output ./linux-plan
rust-mirror fetch --plan ./linux-plan --output ./linux-snapshot

Output parents must exist; existing outputs require an explicit same-plan --resume. The completed static tree is linux-snapshot/mirror. Import a project's rust-toolchain.toml to avoid manually duplicating its components and targets.

The Rustup lifecycle guide explains fresh clients, existing-client updates, retained pinned versions and self-update. Linux, Windows and macOS are explicit host selections; a metadata listing alone never proves native execution. The dated qualification record distinguishes native/server results and pending gates. Nexus tests use an isolated legacy OSS fixture, not your production server. See hosting and limitations.

Planned products

• rust-mirror: core library and CLI, inspired by Panamax. Cargo crate/index mirroring remains planned; scheduling is outside 0.1.0.
• rust-mirror-gui: future interface over the same core. No GUI implementation or framework has been selected.

The repository was renamed from rustup-offline-mirror on 2026-11-09, preserving Git history and stable ROM-REQ identifiers. The earlier Windows-local uncommitted prototype remains untouched and separately preserved; its assessment is historical.

Documentation

• Complete user guide and worked Windows/Unix deployment/update examples.

• Every command, option, config field, report and library entry point.

• Start testing: one-shot sync and demos.

• Multi-version generations and explicit channel refresh.

• Resumable downloads and recovery.

• Toolchain selections, discovery, import and frozen plans.

• Nexus Raw hosting and offline installation.

• Offline proof evidence.

• Recovered prototype assessment.

• Requirements and evidence index.

• Changelog and release policy/checklist.

• Contribution and validation instructions.

• License.