Synchronize Documents using SparkleShare¶

Share documents with your entire team right from your desktop! By using Planio's Git repositories and 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.

• Table of contents
• Synchronize Documents using SparkleShare
  • Install SparkleShare
  • Paste your link code into Planio
  • Create your first Git repository
  • Link SparkleShare to your Planio Git repository
  • You're done!

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.org and download SparkleShare.

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 (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

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

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

Link SparkleShare to your Planio Git repository¶

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

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 are and the second part after the colon in the right. It should look like in the following image.

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.

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.