[[PageOutline(2-5,Contents,pullout)]]
= Bitbucket sync plugin =

== Description ==

This plugin syncs Bitbucket repository with local repository used by Trac.

When a Bitbucket repository is changed, this plugin pulls those changes into the local repository.

After installation of this plugin, you have to configure Bitbucket to notify Trac about changes. You do this on Bitbucket under ''Admin'' -> ''Services'' section, where you select ''POST'' service type and enter an URL of your Trac installation's `/bitbucketsync` handler. For example, if your Trac installation is on `http://www.example.com/` then enter `http://www.example.com/bitbucketsync` as service URL.

Name of the repository on Bitbucket should match (it is case sensitive) the local one (you can use aliases in Trac 0.12 to assure that). User under which Trac is running on the server should have write access to the local repository for which it is configured and you want to sync.

Of course, local repository should be properly configured into Trac (commit and incoming hooks configured and so on). Then also ticket updates through commit messages is possible.

== Bugs/Feature Requests ==

Please use [https://github.com/mitar/trac-bitbucketsync/issues GitHub] for any issues you have with BitbucketSyncPlugin.

== Download ==

Download the zipped source from [https://github.com/mitar/trac-bitbucketsync/archive/master.zip here].

== Source ==

You can clone BitbucketSyncPlugin from [https://github.com/mitar/trac-bitbucketsync here] using Mercurial, or [https://github.com/mitar/trac-bitbucketsync browse the source] on GitHub.

== Installation ==

Please follow [http://trac.edgewall.org/wiki/TracPlugins#InstallingaTracPlugin documentation] on how to install Trac's plugins.

== Author/Contributors ==

'''Author:''' [wiki:mitar] [[BR]]
'''Maintainer:''' [wiki:mitar] [[BR]]
'''Contributors:'''