Project

Profile

Help

Synchronize Documents using Sparkleshare » History » Sprint/Milestone 36

Jan Schulz-Hofen, 02/11/2015 06:19 PM

1 2 Jan Schulz-Hofen
# Synchronize Documents using SparkleShare
2 1 Jan Schulz-Hofen
3 2 Jan Schulz-Hofen
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/).
4 1 Jan Schulz-Hofen
5
{{>toc}}
6
7 2 Jan Schulz-Hofen
## Install SparkleShare
8
9 28 Jan Schulz-Hofen
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.
10 3 Jan Schulz-Hofen
11 29 Jan Schulz-Hofen
**Simply head to [sparkleshare.org](http://sparkleshare.org/) and download SparkleShare.**
12 1 Jan Schulz-Hofen
13
![](sparkleshare_link_code_public_key.png)  
14
*Copying the SparkleShare link code*
15 30 Jan Schulz-Hofen
16
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.
17 3 Jan Schulz-Hofen
18
## Paste your link code into Planio
19 9 Jan Schulz-Hofen
20
Within Planio, navigate to **My account** -\> **Public keys** and click on **Add**.
21 10 Jan Schulz-Hofen
22
Give your key a name, for instance the name of your computer, and paste the SparkleShare link code you copied previously.
23
24 11 Jan Schulz-Hofen
![](adding_a\_public_key_in_planio.png)  
25
*Adding a public key (or link code) in Planio*
26 12 Jan Schulz-Hofen
27
## Create your first Git repository
28
29 16 Jan Schulz-Hofen
Repositories are versioned and secure data storage areas within Planio. You can have as many repositories as you want per project.
30 13 Jan Schulz-Hofen
31
To create one, navigate to any of your Planio projects, and then to **Settings** -\> **Repositories** -\> **New repository**.
32 12 Jan Schulz-Hofen
33
Select *Git* as your **SCM**, and enter an **Identifier**, for example *documents*. Then click **Create**.
34 14 Jan Schulz-Hofen
35 15 Jan Schulz-Hofen
![](creating_a\_git_repository_to_use_with_sparkleshare.png)  
36 14 Jan Schulz-Hofen
*Creating a Git repository to use with SparkleShare*
37 17 Jan Schulz-Hofen
38 35 Jan Schulz-Hofen
### The Git repository URL
39 19 Jan Schulz-Hofen
40 20 Jan Schulz-Hofen
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**.
41 17 Jan Schulz-Hofen
42
![](repository_url_in_sidebar.png)  
43 18 Jan Schulz-Hofen
*Repository URL in sidebar*
44 22 Jan Schulz-Hofen
45 35 Jan Schulz-Hofen
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.
46 34 Jan Schulz-Hofen
47 22 Jan Schulz-Hofen
## Link SparkleShare to your Planio Git repository
48
49
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...**
50
51
![](sparkleshare_in_the_system_menu.png)  
52
*SparkleShare in the system menu*
53 25 Jan Schulz-Hofen
54 36 Jan Schulz-Hofen
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.
55 25 Jan Schulz-Hofen
56 26 Jan Schulz-Hofen
![](enter_planio_git_repository_url_into_sparkleshare.png)  
57
*Entering the Planio Git repository URL into SparkleShare*
58 31 Jan Schulz-Hofen
59
## You're done!
60
61
That's it. Open up that folder on your desktop and add some files. They'll show up in Planio's Git repository immediately.
62
63
![](planio_repository_in_sparkleshare.png)  
64
*Your documents - synchronized!*
65 32 Jan Schulz-Hofen
66
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.