Project

Profile

Help

History

Synchronize Documents using Sparkleshare » History » Revision 38

Revision 37 (Jan Schulz-Hofen, 02/11/2015 06:47 PM) → Revision 38/41 (Jan Schulz-Hofen, 01/05/2016 07:40 AM) 

# Synchronize Documents using SparkleShare 

 Share documents with your entire team right from your desktop! By using Planio's [Git repositories](https://plan.io/subversion-hosting-and-git-hosting/) and [SparkleShare](https://plan.io/sparkleshare/), you can finally replace file sharing solutions such as Dropbox™ or Box™ and benefit from full integration and super [secure hosting made in Germany](https://plan.io/privacy/). 

 {{>toc}} 

 ## Install SparkleShare 

 SparkleShare is a small client app which you can download and install on your computer. It's free and open source and available for Mac OS X, Windows, and Linux. 

 **Simply head to [sparkleshare.io](http://sparkleshare.io/) [sparkleshare.org](http://sparkleshare.org/) and download SparkleShare.** 

 ![](sparkleshare_link_code_public_key.png)   
 *Copying the SparkleShare link code* 

 After the installation has finished, SparkleShare will present you with your unique **Link Code** (or public key as it's called in Planio). Click on the **Copy** button next to it. 

 ## Paste your link code into Planio 

 Within Planio, navigate to **My account** -\> **Public keys** and click on **Add**. 

 Give your key a name, for instance the name of your computer, and paste the SparkleShare link code you copied previously. 

 ![](adding_a\_public_key_in_planio.png)   
 *Adding a public key (or link code) in Planio* 

 ## Create your first Git repository 

 Repositories are versioned and secure data storage areas within Planio. You can have as many repositories as you want per project. 

 To create one, navigate to any of your Planio projects, and then to **Settings** -\> **Repositories** -\> **New repository**. 

 Select *Git* as your **SCM**, and enter an **Identifier**, for example *documents*. Then click **Create**. 

 ![](creating_a\_git_repository_to_use_with_sparkleshare.png)   
 *Creating a Git repository to use with SparkleShare* 

 ### The Git repository URL 

 Next, navigate to the **Repository** tab within your project and select your newly created repository from the sidebar. Still in the sidebar, take note of your **Repository URL**. 

 ![](repository_url_in_sidebar.png)   
 *Repository URL in sidebar* 

 Now, look closely at that repository URL. It contains a colon `:`. The part before the colon is your **address** and the part after is the **remote path**. You will need both in a moment. 

 ## Open your Planio Git repository in SparkleShare 

 Just one more step. Noticed that new SparkleShare icon you've got in your status bar or system tray? Right-click it, then **SparkleShare** -\> **Add Hosted Project...** 

 ![](sparkleshare_in_the_system_menu.png)   
 *SparkleShare in the system menu* 

 In the window that pops up, scroll down, select **Planio** from the provider list. Now, enter the first part of your **Repository URL** before the colon `:` in the left text area and the second part after the colon in the right. It should look like in the following image. 

 ![](enter_planio_git_repository_url_into_sparkleshare.png)   
 *Entering the Planio Git repository URL into SparkleShare* 

 ## You're done! 

 That's it. Open up that folder on your desktop and add some files. They'll show up in Planio's Git repository immediately. 

 ![](planio_repository_in_sparkleshare.png)   
 *Your documents - synchronized!* 

 Now, have your colleagues repeat this little exercise after you and you will be able to share documents and files with each other via Planio.