Skip to main content
Jump to: navigation, search

Releasing Tycho

This page describes the steps necessary to create releases of the Tycho project.

  1. Make sure all bugs have the correct target milestone for this release
  2. Schedule a new release and generate the IP log on
  3. Prepare the Tycho/Release Notes which should provide a quick overview of new features and bug fixes
  4. Link the N&N to the release review
  5. At least once per year, a review is required. In that case, send email to to review the release docs.
  6. Update versions using
    mvn org.eclipse.tycho:tycho-versions-plugin:set-version -DnewVersion=...
  7. Commit version change, and create a git tag tycho-<VERSION> on this commit
  8. Update versions (same as above) to next -SNAPSHOT development version and push commit to master branch
  9. Create the new version and milestone in the bugzilla manager
  10. Make sure you have everything setup (GPG installed!) for deploying to the Nexus OSS repository, see guide
  11. Add your credentials for server sonatype-nexus-staging in ~/.m2/settings.xml
<settings xmlns="" xmlns:xsi="" xsi:schemaLocation="">
   <!-- ... -->
      <password>securePassword</password> <!-- use `mvn --encrypt-password` to not store plain text -->
    <!-- ... -->
  1. Checkout the tag version tycho-<VERSION> so current commit is the tag.
  2. Sync to release commit and deploy to nexus staging repository:
    mvn clean deploy -Prelease -DforgeReleaseId=sonatype-nexus-staging -DforgeReleaseUrl=
  3. In parallel of previous mvn command, prepare update tycho-demo projects to the latest release and push the change as a review to Gerrit
  4. When previous mvn command is complete, generate site docs using mvn install site site:stage -DskipTests and check the result from target/staging seems viable.
  5. On , Close the staging repository, get the staging repo URL from Nexus
  6. Update to replace reference to snapshot build to reference to staging repo
  7. Announce the temporary stage URL on
Subject: please test staged tycho <VERSION>

Tycho release <VERSION&> has been staged. For details of new features and bugfixes, see release notes [1].
Please help by testing the staged build. To use it, change your tycho version to <VERSION> and add snippet [2] to your pom.

We plan to promote this release in one week unless major regressions are found.

Tycho team

  1. Prepare documentation on the webite, using git repo : copy the local site docs folders target/staging/sitedocs to the existing sitedocs folder and then submit as Gerrit review (don't merge yet)

... Wait until review date (usually a week later)...

  1. After ~1 week of testing, promote the stage repository on
  2. Wait for artifacts to be available on Maven central.
  3. Push the release tags to git: git push origin --tags
  4. Update to remove reference to staging repo
  5. Browse the Tycho wiki pages to update any hardcoded tycho versions to the latest version
  6. Merge the update to org.eclipse.tycho-demo and website in Gerrit
  7. Announce the release
    1. Find out who contributed to the release:
git log --pretty=format:%an tycho-<previousVersion>..tycho-<newVersion> | sort | uniq
git log --grep="Also-[bB]y:" tycho-<previousVersion>..tycho-<newVersion> | grep -i also-by | sed -e 's/.*Also-[bB]y:\s*\(.*\)/\1/' | sort | uniq
    1. Announce the release on,, thanking the contributors:
Subject: Tycho <n> released

Tycho <n> has been released and is available from Maven Central repository.

See the release notes 
[1]<n> for details of enhancements and bug fixes in this release.

Thanks to 
who contributed patches for this release, and thanks and to everyone who helped us with testing the staged version.


    1. Optionally, announce on other medias (Twitter)
    2. Create, push and merge patch changing the bootstrap Tycho version for Tycho build (eg )

Back to the top