Skip to main content

Release Process

At Chatwoot, we follow a monthly release schedule. On 15th of every month, we will release a new version of the software. To release the version of the software, use the following guide.

Github release process#

We use git-flow as our branching strategy.

1. Pull the latest changes#

Pull latest develop branch and master branch in your local machine.

git checkout mastergit pullgit checkout developgit pullgit fetch --tags

2. Commit new version#

3. Prepare release#

git flow release start '1.12.0' # replace your version numbergit flow release finish '1.12.0' # replace your version number
# Leave default merge messages as it is# prepare the tag message as 'v1.12.0' # replace your version number

4. Reverse merge master#

Reverse merge master branch to develop branch.

git checkout developgit merge master

5. Push changes to remote#

Push master branch, develop branch and the tags.

# Push developgit checkout developgit push --no-verify
# Push mastergit checkout mastergit push --no-verify
# Push tagsgit checkout developgit push --tags --no-verify

6. Prepare release notes#

  • Compare the current version to the previous version using the tag compare feature in Github.
  • Create a new release on Github from existing tags and update release notes.
  • Ensure that the milestones exist for the subsequent 2 versions.
  • Close the current milestone and move issues to the next milestone.

Release note format:

- Describe the changes in the current release- List the new languages that are added in the new release- Gratitudes towards who have contributed to the project.

Release note example:

## Changelog
- Ability to detect contact location- Ability to download Agent reports- Search contacts using the phone number- Set up dev environments with GitHub codespaces- Ability to set Installation wide default language- Improved alerts on agent/user typing- Limit file types that can be attached- Ability for external systems to authenticate users into Chatwoot using tokens- Numerous bug fixes and enhancements
- New Languages  - Danish  - Korean  - Czech  - Turkish  - Finnish  - Indonesian
###Thanks to @azyzio, @hiaselhans, @vishal-pandey, @troscoe, @timcowlishaw, @mike9011 for the contributions

Todos after Github release#

  • Create release notes in Changelog ( If you don't have access to the blog, please contact Pranav / Sojan.
  • Update the latest version in Chatwoot Hub. This is used to show a notification to users using self-hosted installation.
  • Create tasks in Product board to deploy the changes to our paid clients.