Title: Gitium
Author: Presslabs
Published: <strong>juin 22, 2014</strong>
Last modified: décembre 10, 2025

---

Search plugins

![](https://ps.w.org/gitium/assets/banner-772x250.png?rev=1148876)

![](https://ps.w.org/gitium/assets/icon-128x128.png?rev=1610345)

# Gitium

 By [Presslabs](https://profiles.wordpress.org/presslabs/)

[Download](https://downloads.wordpress.org/plugin/gitium.1.2.2.zip)

 * [Details](https://tah.wordpress.org/plugins/gitium/#description)
 * [Reviews](https://tah.wordpress.org/plugins/gitium/#reviews)
 *  [Installation](https://tah.wordpress.org/plugins/gitium/#installation)
 * [Development](https://tah.wordpress.org/plugins/gitium/#developers)

 [Support](https://wordpress.org/support/plugin/gitium/)

## Description

Automatic git version control and deployment for your plugins and themes integrated
into wp-admin.

### About the makers

This plugin was developed by the crafty people at Presslabs—the Smart Managed WordPress
Hosting Platform. Here we bring high-performance hosting and business intelligence
for WordPress sites. In our spare time, we contribute to the global open-source 
community with our code.

We’ve built Gitium back in 2013 to provide our clients a more simple and error-free
method to integrate a new git version control into their code management flow.

### What is Gitium?

This plugin enables continuous deployment for WordPress, integrating with tools 
such as Github, Bitbucket or Travis-CI. Theme or plugin updates, installs and removals
are all automatically versioned. Ninja code edits from the WordPress editor are 
also tracked by the version control system.

### Why is Gitium?

Gitium is designed with responsible development environments in mind, allowing staging
and production to follow different branches of the same repository. You can also
deploy code by simply using git push.

Gitium requires git command line tool with a minimum version of 1.7 installed on
the server and the proc_open PHP function enabled.

### Gitium features:

-preserves the WordPress behavior
 -accountability for code changes -safe code storage—
gets all code edits in Git

### Development

For more details about Gitium, head here: http://docs.presslabs.com/gitium/usage/

### Receiving is nicer when giving

We’ve built this to make our lives easier and we’re happy to do that for other developers,
too. We’d really appreciate it if you could contribute with code, tests, documentation
or just share your experience with Gitium.

Development of Gitium happens at http://github.com/PressLabs/gitium
 Issues are 
tracked at http://github.com/PressLabs/gitium/issues This WordPress plugin can be
found at https://wordpress.org/plugins/gitium/

## Screenshots

 * [[
 * Setup step 1: Get SSH Key
 * [[
 * Setup step 2: Set SSH Key (Github)
 * [[
 * Setup step 3: Add remote repository
 * [[
 * Setup step 4: Choose following branch
 * [[
 * Commit local changes

## Installation

#### Manual Installation

 1. Go to your WordPress admin dashboard.
 2. Navigate to ‘Plugins’  ‘Add New’.
 3. Search for « Gitium ».
 4. Install and activate the Gitium plugin.

#### Usage

 * Connect Your Repository
    After activation, go to the Gitium settings in your 
   WordPress admin area. Copy the Public Key that Gitium has generated for you from
   the Key Pair field. In your repository manager of choice (GitHub, GitLab, or 
   Bitbucket), go to the settings page and find the “Deploy keys” (or similar) section.
   There you will need to add the Public Key you’ve copied from Gitium. This will
   grant Gitium access to your repository. Make sure to allow write access as well.
   Also make sure that you copy the entire key from gitium. Now go back to your 
   main repository page and copy the SSH URL to your repo. Paste this URL in Gitium
   and press the “Fetch” button. A “Repository initialized successfully” message
   will show up. This means that your repository has been populated with the current
   code of your website and it is ready to start working with Gitium.
 * Initial Commit
    Once connected, Gitium will automatically commit your existing
   WordPress theme and plugins to the connected repository. This initial commit 
   serves as the baseline for your site’s code.
 * Making Changes
    Make changes to your WordPress site’s code (themes, plugins) 
   as needed. Gitium will automatically commit these changes to your Git repository.
   Using the webhook provided by Gitium, it will also automatically deploy the changes
   from the repository to your WordPress site.
 * Webook Configuration
    Gitium uses the webhook to automatically deploy remote 
   changes to your server. To configure it follow these steps:
    1. Go to your WordPress website and go to your Gitium Settings page;
    2. Copy the full Webhook URL that Gitium provides;
    3. In your Git Manager settings, go to Webhook section, add a new webhook and paste
       the webhook URL you have copied from Gitium.
    4. Press Add, no settings changes needed. The webook simply needs a ping, nothing
       more. The security key is already embedded in the final URL Gitium has generated
       for you.

Now when you push to your repo, this webhook will automatically pull the changes
to your remote server and deploy them.

You can see more details about the plugin also in our documentation here: https://
www.presslabs.com/docs/code/gitium/install-gitium/

## FAQ

### Could not connect to remote repository?

If you encounter this kind of error you can try to fix it by setting the proper 
username of the .git directory.

Example: chown -R www-data:www-data .git

### Is this plugin considered stable?

Yes, we consider the plugin stable after extensive usage in production environments
at Presslabs, with hundreds of users and powering sites with hundreds of millions
of pageviews per month.

### What will happen in case of conflicts?

The behavior in case of conflicts is to overwrite the changes on the `origin` repository
with the local changes (ie. local modifications take precedence over remote ones).

### How to deploy automatically after a push?

You can ping the webhook url after a push to automatically deploy the new code. 
The webhook url can be found under `Gitium` menu, `Settings` section. This url also
plays well with Github or Bitbucket webhooks.

### Does it works on multi site setups?

Gitium does not support multisite setups at the moment.

### How does gitium handle submodules?

Submodules are currently not supported.

### Where do I report security bugs found in this plugin?

Please report security bugs found in the source code of the Gitium plugin through
the [Patchstack Vulnerability Disclosure Program](https://patchstack.com/database/vdp/gitium).
The Patchstack team will assist you with verification, CVE assignment, and notify
the developers of this plugin.

## Reviews

![](https://secure.gravatar.com/avatar/70451cc6bb471bcea2d1a72928090d3990f9d564956a9ecce349a7cd6d117b0c?
s=60&d=retro&r=g)

### 󠀁[It completely wiped my entire wordpress directory, including itself](https://wordpress.org/support/topic/completely-wiped-my-entire-wordpress-directory/)󠁿

 [katuchan](https://profiles.wordpress.org/katuchan/) décembre 29, 2025 1 reply

I literally could not tell you what went wrong, but I strongly recommend you don’t
use this plugin unless you’re very good at what you do. I installed/activated plugin.
Added the SSH key to my github account, made and initialized a new repo, and hit
confirm. It sent me to the success URL, which it said I didn’t have permission to
view. Whatever, I thought, WP is weird sometimes. I went back to wp-admin/ and noticed
that there was an error up top. And…that my sidebar was completely reset to default.
I checked my plugins, and was met with many errors that my plugins could not be 
shown because the files were missing. My theme is also completely nuked. And, of
course, I don’t have a recent backup because I am a fool. So don’t be like me. Use
this plugin very much at your own risk, and absolutely take regular manual backups
of your stuff.

![](https://secure.gravatar.com/avatar/9be5f83e57e514b47b725fc364e2a826e503fd5e9ba5efb66ad8261f7d10cda7?
s=60&d=retro&r=g)

### 󠀁[wp-admin crash during activating](https://wordpress.org/support/topic/wp-admin-crash-during-activating/)󠁿

 [andrii.trush](https://profiles.wordpress.org/yog1ck/) septembre 3, 2016 2 replies

Error during activating your app

![](https://secure.gravatar.com/avatar/af90f71b4ab9bec7b838c3e4aeae44016a941f19fc7ab50663c1bd29643c975d?
s=60&d=retro&r=g)

### 󠀁[You've got to try it!](https://wordpress.org/support/topic/youve-got-to-try-it/)󠁿

 [razvan.mocanu](https://profiles.wordpress.org/razvanmocanu/) février 8, 2017

Really easy to use, would recommend even to beginners.

![](https://secure.gravatar.com/avatar/04cd75ff168cea6c94f92a1c154bfe242192198b7b896e614b2b585900e78c86?
s=60&d=retro&r=g)

### 󠀁[Game changing](https://wordpress.org/support/topic/game-changing/)󠁿

 [tolci.ionut](https://profiles.wordpress.org/tolciionut/) février 8, 2017

Git alone is awesome, but keeping track of the changes made on a website via git
is even more awesome.

![](https://secure.gravatar.com/avatar/274d9446613f4173b63232bd444409f35342b601ebbd2c0d86f4431126a389c5?
s=60&d=retro&r=g)

### 󠀁[Awesome!](https://wordpress.org/support/topic/awesome-4197/)󠁿

 [Olar Marius](https://profiles.wordpress.org/olarmarius/) février 8, 2017

This plugin is very simple to use.

![](https://secure.gravatar.com/avatar/be9f53bf827675878f552b156ccd42e198e3fd5576aac1bb1d5f296501c90339?
s=60&d=retro&r=g)

### 󠀁[The future is here 😀](https://wordpress.org/support/topic/the-future-is-here-d/)󠁿

 [krotz](https://profiles.wordpress.org/krotz/) février 8, 2017

As a developer this makes tracking who and when things changed a lot easier, while
allowing people to roll back at a snap of ones fingers. Definitely a must in any
build. <3

 [ Read all 10 reviews ](https://wordpress.org/support/plugin/gitium/reviews/)

## Contributors & Developers

“Gitium” is open source software. The following people have contributed to this 
plugin.

Contributors

 *   [ Presslabs ](https://profiles.wordpress.org/presslabs/)

[Translate “Gitium” into your language.](https://translate.wordpress.org/projects/wp-plugins/gitium)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/gitium/), check out
the [SVN repository](https://plugins.svn.wordpress.org/gitium/), or subscribe to
the [development log](https://plugins.trac.wordpress.org/log/gitium/) by [RSS](https://plugins.trac.wordpress.org/log/gitium/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.2.2

 * Tested the compatibility of the plugin with WP 6.9

#### 1.2.1

 * Tested the compatibility of the plugin with WP 6.8

#### 1.2.0

 * Changed the license for all files to GPLv3
 * Fix: In some cases, the WP is configured in another folder. We’ve made some changes
   on how we check for the wp-load.php file

#### 1.1.0

 * Fix: In some cases, the website was stuck in maintenance when it was pulling 
   the changes from remote
 * Added: A copy-to-clipboard button was introduced for copying ssh key-pair and
   webhook url

#### 1.0.7

 * Fix: HOME env definition;
 * Fix: deprecation warnings in PHP 8.1;
 * Compat: added composer.json package;
 * Compat: add the possibility to use a custom `.gitignore` by defining the `GITIGNORE`
   constant.

#### 1.0.6

 * Fixed deprecation warnings for dynamic property in git-wrapper

#### 1.0.5

 * Various bug fixes

#### 1.0.4

 * PHP 8 compat. fixes

#### 1.0.3

 * Fixed wrong redirection for multisite installations during initial setup

#### 1.0.2

 * Full PHP 7+ compatibility
 * Hotfix – Fixed the blank pages being displayed instead of success of failure 
   messages;
 * Hotfix – Fixed the push process when other remote branches had changes;
 * Hotfix – Fixed the missing ssh / key handling with fatal errors during activation;
 * Added – More success messages in certain cases.

#### 1.0.1

 * Hotfix – Fix race condition on Code Editor Save

#### 1.0

 * Fixed WP 4.9 Compatibility

#### 1.0-rc12

 * Bumped plugin version

#### 1.0-rc11

 * Hotfixed an error that prevented gitium to error_log properly.

#### 1.0-rc10

 * Bumped wordpress tested version

#### 1.0-rc9

 * PHP7 compat and wp-cli

#### 1.0-rc8

 * Fix some indents
 * Add some more tests
 * Fix the submenu configure logic

#### 1.0-rc7

 * Test remote url from git wrapper
 * Remove the phpmd package from test environment
 * Set WP_DEBUG to false on tests
 * Refactoring
 * Abort the cherry-pick – changes are already there
 * Fix the race condition
 * Add acquire and release logs for gitium lock
 * Add explanations to merge with accept mine logic

#### 1.0-rc6

 * Delete all transients and options on uninstall hook
 * Add transients to is_versions and get_remote_tracking_branch functions
 * Update the composer
 * Check requirements before show the admin menu
 * Put the logs off by default(on test env)
 * Fix redirect issue and display errors
 * Create wordpress docker env command
 * PHP Warning: unlink #114

#### 1.0-rc5

 * Fix delete plugin/theme bug on 4.6
 * Update the readme file

#### 1.0-rc4

 * Fix merge with accept mine behind commits bug

#### 1.0-rc3

 * Add support for multisite
 * Fix PHP error on merge & push

#### 1.0-rc2

 * Change the default lockfile location
 * Fix a PHP Warning

#### 1.0-rc1

 * Update the logic of merge and push
 * Add lock mechanism for fetch and merge
 * Fix repo stuck on merge_local branch
 * Tested up to 4.5.3

#### 0.5.8-beta

 * Add documentation for ‘Could not connect to remote repository?’
 * Fix the update theme from Dashboard commit message & the install plugin commit
   message
 * Fix install/delete plugin/theme commit message
 * Add a test and rewrite the tests
 * Tested up to 4.5.2

#### 0.5.7-beta

 * Fix bug deleting plugins/themes causes wrong commit message
 * Fix bug wrong commit message
 * Fix bug updated function to stop maintenance mode hang
 * Fix bug undefined variable ‘new_versions’
 * Add ‘Merge changes’ button for gitium webhook
 * Add gitium documentation for docker
 * Add more tests

#### 0.5.6-beta

 * Fix compatibility issues with wp-cli

#### 0.5.5-beta

 * Fix bug plugin deletion from plugins page did not trigger commit

#### 0.5.4-beta

 * Fix bug missing changes on similarly named plugins
 * Add requirements notices
 * Add requirements help section

#### 0.5.3-beta

 * Fix paths with spaces bug
 * Add a Disconnect from repo button
 * Fix POST var `path` conflicts
 * Fix travis tests

#### 0.5.2-beta

 * Add Contextual Help to Configuration page
 * Make the icon path relative
 * The key file is deleted properly
 * Update serbian translation
 * Make the resource type more specific
 * Fix Menu Bubble
 * Remove useless param for get_transient
 * Add Spanish Translation
 * Rename `gitium_version` transient
 * Fix git version notice
 * Delete .vimrc
 * Update .gitignore
 * Fix syntax error
 * Add better git version check
 * Fix add_query_arg vulnerability

#### 0.5.1-beta

 * Update Serbian Translation (by [Ogi Djuraskovic](http://firstsiteguide.com/))
 * Fix Menu Bubble

#### 0.5-beta

 * Add `Last 20 Commits` menu page
 * Add WordPress Contextual Help menu
 * Add `Settings` menu page
 * Move `Webhook URL` and `Public Key` fields to `Settings` page
 * Add menu icon
 * The `.gitignore` file can be edited
 * Fix commit message on theme/plugin update event
 * Refactoring

#### 0.4-beta

 * Add `Bitbucket` documentation link
 * Add the action `gitium_before_merge_with_accept_mine`
 * Moved to `travis-ci.org`
 * Add new tests
 * Added code climate coverage reporting
 * Refactoring

#### 0.3.2-alpha

 * Fix plugin activation issues

#### 0.3.1-alpha

 * Fix issues with ssh repositories
 * Fix maintemance mode when webhook fails

#### 0.3-alpha

 * First alpha release

## Meta

 *  Version **1.2.2**
 *  Last updated **4 mois ago**
 *  Active installations **400+**
 *  WordPress version ** 4.7 or higher **
 *  Tested up to **6.9.4**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/gitium/)
 * Tags
 * [git](https://tah.wordpress.org/plugins/tags/git/)[presslabs](https://tah.wordpress.org/plugins/tags/presslabs/)
   [revision](https://tah.wordpress.org/plugins/tags/revision/)[version control](https://tah.wordpress.org/plugins/tags/version-control/)
 *  [Advanced View](https://tah.wordpress.org/plugins/gitium/advanced/)

## Ratings

 4.1 out of 5 stars.

 *  [  7 5-star reviews     ](https://wordpress.org/support/plugin/gitium/reviews/?filter=5)
 *  [  1 4-star review     ](https://wordpress.org/support/plugin/gitium/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/gitium/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/gitium/reviews/?filter=2)
 *  [  2 1-star reviews     ](https://wordpress.org/support/plugin/gitium/reviews/?filter=1)

[Add my review](https://wordpress.org/support/plugin/gitium/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/gitium/reviews/)

## Contributors

 *   [ Presslabs ](https://profiles.wordpress.org/presslabs/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/gitium/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://www.presslabs.com/gitium/)