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
    • The Git repository URL
  • Open your Planio Git repository in SparkleShare
  • 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.io 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 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

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.

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.