59 votes

uSync

uSync in an umbraco package that takes the bits of umbraco that are stored in a database and moves them to disk, so you can source control, copy and move your umbraco site between computers and servers.

Via Nuget:

Install-Package uSync

or download one of the packages below

uSync will read/write:

  • Document types

  • Media Types

  • Data Types

  • Macros

  • Dictionary Items

  • Languages

  • Member Types

  • Templates

  • Stylesheets (no longer stored in the db in umbraco 7.3+)

Source Control

Whenever you make a change usync can write that out to disk, so you can check it in with all your other changes, uSync will also import everything from disk so when you checkout other people’s code, their changes will be reflected on your build.

Deployment

uSync isn’t a deployment system, but with everything written out to disk, ready for import you can copy the files over to your target systems and run imports to make changes. To run uSync as part of your deployment you will probably want to tweak a few settings.

What uSync Does

uSync gets the bits of umbraco that are stored in the DB and writes them out to disk - any changes it detects are written out in the form of xml files to the uSync/Data folder

if you want to deploy or source control your site you will also need to copy / save the other folders that umbraco writes to, such as the /views/ /css/ and /scripts folders.

uSync Versions

I do try to be good with version control, but it’s can get confusing when targeting so many different versions of umbraco - as of V7.4 of umbraco these are the current editions of uSync for each version.

Umbraco Version

uSync

Download

Umbraco 7.4+

3.1.x.740

uSync.BackOffice.3.x.740.zip

Umbraco 7.3.x

3.0.x

uSync.BackOffice.3.0.x.zip

Umbraco 7.x - 7.2.x

2.5.x

uSync_2.5.0.zip

Umbraco 6.2.5+

2.2.6

uSync2.2.6_Umbraco6.2.5.zip

Umbraco 6.2.x - 6.2.4

2.2.5

uSync2.2.5_Umbraco6.2.zip

Umbraco 6.1.x

1.6 - 2.2.x

uSync 1.6 for Umbraco6.1.zip*

Umbraco 6.0.x

No Version

-

Umbraco 4.10+

1.3.3

uSync_1.3.3_Umbraco4.zip

*your millage may vary, but uSync 1.6 does seem to work well for Umbraco 6.2.x and it is more feature ritch than usync 2.2.x for umbraco 6.2

There are so many versions, because as little things change in the core of umbraco how that data is extracted and imported changes, going forward we are trying to keep the minimum umbraco version in the tail of the uSync version you can easily identify a version that works.

Related Packages

uSync.ContentEdition : Adds the ability to sync content and media items as part of uSync

uSync.Snapshots: Allows you to take moment in time snapshots of changes you have made

uSync.Core (below) : The core usync engine & API - allowing you to write your own syncing routines

Screenshots

Archived files

Source code

 Download package
version 3.1.4

Project owner

Kevin Jump

Kevin Jump

Kevin has 3363 karma points

Project Compatibility

This project is compatible with the following versions as reported by community members who have downloaded this package:
Untested or doesn't work on Umbraco as a Service
7.4.x (100%)
7.3.x (100%)
7.2.x (100%)
7.1.x (100%)
7.0.x (untested)
6.1.x (100%)
6.0.x (untested)
4.11.x (100%)
4.10.0 (untested)
4.9.1 (untested)
4.9.0 (untested)

You must login before you can report on package compatibility.

Project Information

  • Project owner: Kevin Jump
  • Created: 22/02/2013
  • Current version 3.1.4
  • .net Version 4.0,4.5
  • License MIT
  • Downloads: 11565

External resources

Our.umbraco.org is the community mothership for Umbraco, the open source asp.net cms. With a friendly forum for all your questions, a comprehensive documentation and a ton of packages from the community. This site is running Umbraco version 7.5.0-beta2