Planio Support (english)

# 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/) 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.