Create a Rust crate

To create a crate, you can use Cargo CLI’s new command:

cargo new hello_repsy
cd hello_repsy

If this command is executed successfully, Cargo will generate a project directory with a Cargo.toml file and source files automatically. This file is required to publish your crates.

Configure your alternate registry

You currently have a basic crate project. The only missing part is the registry configuration and authentication. Create or update $HOME/.cargo/config.toml in your project as follows:

[registries.repsy]
index = "sparse+https://<your-repsy-host>/<repo-name>/"

[registry]
global-credential-providers = ["cargo:token"]

This configuration defines your Repsy registry for Cargo operations.

Authenticate and publish

In order to successfully publish crates to your cargo registry, you must authenticate. To authenticate, run:

Cargo sends a single token, not a username and a password. Use a deploy token with the Read/Write access type: the password of a user account does not work as the token.

cargo login --registry repsy <your-deploy-token>

If this command is executed successfully, you will be authenticated and ready to publish your crate. As a final step, please run:

cargo publish --registry repsy

If you have uncommitted changes in your project but want to proceed with the publishing process, you can use the --allow-dirty flag.

cargo publish --registry repsy --allow-dirty

With this command Cargo will package and publish your crate to your cargo registry.

Congratulations, you have created and published a crate to your registry! You can now install your crate into any project you want and use safely.