# gitlab-cargo-shim[Example configuration][example-configuration]Say goodbye to your Git dependencies, `gitlab-cargo-shim` is a stateless SSH server that serves crates like a standard Cargo registry but from a [GitLab package registry][gitlab-package-registry], allowing you to use your private dependencies like any other dependency. No more `git push --force`s breaking your builds & get proper versioning in one simple little binary.Access controls work like they do in GitLab, builds are scoped to users - if they don't have permission to the dependency they can't build it, it's that simple.Users are either identified by their SSH keys from GitLab when connecting to the server or by an Gitlab personal-token. If no token is given, an [impersonation token][imp-token] will be generated for that run in order to pull available versions. Doing so requires ad admin personal token.To publish run `cargo package` and push the resulting `.crate` file to the GitLab package repository with a semver-compatible version string, to consume the package configure your `.cargo/config.toml`, `Cargo.toml` and, optionally, `.ssh/config` accordingly.At time of writing, `libssh2`, which `cargo` implicitly uses for communicating with the registry by SSH, is incompatible with rust's `thrussh`, due to non-overlapping ciphers. Hence, activating `net.git-fetch-with-cli` is necessary.```toml``````ssh-config```In your CI build, setup a `before_script` step to replace the connection string with one containing the CI token:```yaml```(or add the corresponding [environment variable][envvar])To release your package from CI, add a new pipeline step:```yaml```It's that easy. Go forth and enjoy your newfound quality of life improvements, Rustacean.[gitlab-package-registry]: https://docs.gitlab.com/ee/user/packages/package_registry/index.html[imp-token]: https://docs.gitlab.com/ee/api/index.html#impersonation-tokens[envvar]: https://doc.rust-lang.org/cargo/reference/registries.html#using-an-alternate-registry[example-configuration]: https://github.com/w4/gitlab-cargo-shim/blob/main/config.toml