Skip to content
🧔 Automated release management for leiningen projects
TypeScript JavaScript
Branch: master
Clone or download
Pull request Compare This branch is 27 commits ahead, 7 commits behind conveyal:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


semantic-release plugin to publish a leiningen project.

CircleCI Greenkeeper badge codecov type-coverage npm

Step Description
verifyConditions Checks the project.clj is syntactically valid.
prepare Update the project.clj version and package the output jar file.
publish Publish the jar (and generated Maven metadata) to a maven repository (or clojars).


$ npm install leiningen-semantic-release -D


The plugin can be configured in the semantic-release configuration file:

  "plugins": [
      "assets": ["project.clj"]


Registry authentication

Authenticating with the registry is configured using the :deploy-repositories map in project.clj.

The recommended way to pass these variables in is by using environment variables.

Environment variables

Variable Description
LEIN_USERNAME The username for the maven repository you are publishing to (or clojars).
LEIN_PASSWORD The password for the maven repository you are publishing to (or clojars).
LEIN_PASSPHRASE A gpg passphrase to retreive the username and password with. (if retreiving credentials from gpg)

As mentioned in the leiningen documentation, your :deploy-repositories section of project.clj should be set up to use environment variables.

For example to use LEIN_USERNAME and LEIN_PASSWORD your config might look like this.

:deploy-repositories [["releases" {:url ""
                                   :username :env
                                   :password :env}
                       "snapshots" {:url ""
                                    :username :env
                                    :password :env}]]

If you want retrieve the username and password from gpg, you can set the LEIN_PASSPHRASE environment variable and use config like the following.

:deploy-repositories [["releases" {:url ""
                                   :creds :gpg
                                   :passphrase :env}
                       "snapshots" {:url ""
                                    :creds :gpg
                                    :passphrase :env}]]

The example project shows an example of how to get signing working properly using environment variables on CircleCI.

It techniques used there should apply to most build environments running on Linux.


Options Description Default
skipDeploy Whether to publish the package to a respository with lein deploy. If true the project.clj version will still be updated. true
pkgRoot Directory path to publish. .
uberJar Whether to package the project as an uber jar (include dependencies in the jar) false

Note: The pkgRoot directory must contains a project.clj. The version will be updated only in the project.clj within the pkgRoot directory.

Note: If you use a shareable configuration that defines one of these options you can set it to false in your semantic-release configuration in order to use the default value.


There is an example project at:

You can’t perform that action at this time.