Git (Crate Index) Configuration
The "crate index" is a
git repository hosted at git.shipyard.rs, which stores metadata about which crate versions are
available at your organization's registry server.
In the case of Crates.io's github repository, no authentication is required, since the repository is publicly available. Shipyard.rs Crate Index repositories, intended for proprietary code reuse, are configured to be private by default.
Unlike the Crates.io github repository, you must configure authentication to access the Shipyard.rs crate index, which is not publicly available.
Authentication for the Crate Index repository works the same as authentication for Github or other git hosts, either via HTTPS with username/password, or by adding an SSH public key to perform key-based authentication.
Adding SSH Keys
Adding SSH public keys for accessing your registry's
crate-index repository hosted at git.shipyard.rs
can be done using directly from Shipyard.rs (vs. logging into git.shipyard.rs) using the
tools on the Git Index page. Full details are included in the SSH-based Authentication
Logging into git.shipyard.rs
When a new Shipyard.rs user account is created, a parallel user account is created for the user at git.shipyard.rs, using the same email/password the user registered with for the main Shipyard.rs site.
Using those credentials, users can log in to the git server (running Gitea under the hood) to perform administrative actions such as adding SSH keys to their account.
Note: this functionality is not currently available for accounts using Google Oauth for authentication.
Logging into the Gitea account directly is not required, and generally not needed to use the registry server, but remains available for advanced configuration and account maintenance.
Git Index Privacy
Your organization, its users, and the contents of the
crate-index git repository created for your account are not visible to other users of Shipyard.rs when they log in to git.shipyard.rs.
crate-index Must Exist
Please do not delete the
crate-index repository or the Gitea organization account if you wish to continue using the Shipyard.rs registry server. The
crate-index repository is the authoritative storage for metadata about which crates and crate versions have been published to your registry server.