Skip to main content

​
Official Changelog

The official changelog for Cap is maintained on GitHub Releases, where you can find detailed information about each version including new features, bug fixes, and breaking changes.

View Changelog on GitHub

See all releases, release notes, and download links

​
Latest Releases

For the most up-to-date information about Cap releases:
1

Check GitHub Releases

Visit the Releases page to see all versions with detailed changelogs.
2

Desktop App Updates

The Cap Desktop app automatically checks for updates and will notify you when a new version is available.
3

Self-Hosted Updates

For self-hosted instances, pull the latest changes from the repository:
git pull origin main
docker compose down
docker compose up -d --build

​
Release Channels

​
Stable Releases

Stable releases are thoroughly tested and recommended for production use:
  • Desktop apps available at cap.so/download
  • Tagged releases on GitHub
  • Docker images tagged with version numbers

​
Development Builds

For the latest features and fixes (may be unstable):
  • Build from the main branch
  • Docker images tagged as latest
  • See Contributing Guide for development setup

​
What’s New

Stay informed about Cap development:

GitHub Releases

Official release notes and downloads

Commit History

See all recent changes and commits

Pull Requests

Preview upcoming features

Discord

Discuss updates with the community

​
Version History

Cap follows semantic versioning (MAJOR.MINOR.PATCH):
  • MAJOR - Breaking changes that may require migration
  • MINOR - New features and improvements (backward compatible)
  • PATCH - Bug fixes and minor updates
The version numbering started when Cap became open source. For the complete history, see the GitHub Releases page.

​
Breaking Changes

Major version updates may include breaking changes. Always check the release notes before updating:
Before upgrading a self-hosted instance:
  1. Read the release notes carefully
  2. Backup your database and uploaded files
  3. Test in a staging environment if possible
  4. Follow any migration instructions provided

​
Deprecation Notices

Features scheduled for removal will be announced in advance:
  • Deprecation warnings in release notes
  • Grace period for migration
  • Migration guides provided when needed

​
Update Notifications

​
Desktop App

The Cap Desktop app automatically checks for updates:
  • Notification appears when new version is available
  • Option to download and install automatically
  • Release notes displayed in the update dialog

​
Self-Hosted

To stay informed about updates for self-hosted instances:
  1. Watch the GitHub repository:
    • Click “Watch” → “Custom” → “Releases”
    • Get notified of new releases via email
  2. Check regularly: 
    git fetch origin
git log HEAD..origin/main --oneline
  3. Join Discord:
    • Announcements channel for major updates
    • Community discussion about changes

​
Contributing to Changelog

When contributing to Cap:
  1. Pull Requests: Clearly describe changes in PR description
  2. Commit Messages: Use conventional commit format:
    • feat: for new features
    • fix: for bug fixes
    • docs: for documentation
    • chore: for maintenance tasks
  3. Release Notes: Maintainers compile PR descriptions into release notes
See the Contributing Guide for details.

​
Roadmap

Interested in what’s coming next? Check out:

Project Roadmap

See planned features and future direction

​
Feedback on Releases

Help improve Cap by sharing feedback on releases:
  • Report bugs in new versions on GitHub Issues
  • Discuss changes on Discord
  • Test beta/RC versions and provide feedback
  • Suggest improvements to the release process

​
Download Previous Versions

Need an older version of Cap?
  1. Visit GitHub Releases
  2. Scroll to the desired version
  3. Download from the Assets section
For self-hosted instances, you can check out any git tag:
git checkout tags/v1.0.0

​
Stay Updated

Never miss an update:

Watch on GitHub

Get release notifications

Follow on Twitter

Release announcements

Join Discord

Community updates

Build docs developers (and LLMs) love

Get started for freeTalk to us