Sync Docs  
Home | Download | Getting Started | SyncDocs at SourceForge | Screenshots | CVS | FAQ | To do | Contact Me

Troubleshooting SyncDocs

First, check to make sure you're using the latest version of SyncDocs. Check to see if your problem is in the list on the FAQ page. Then, please check to see if your issue is any of the following:

Double-clicking the JAR icon doesn't launch SyncDocs.
The SyncDocs server never shows up in the list on my mobile device.
It seems to take forever to upload or download files.
I tried to send files to my mobile device but it says that it didn't find any files.
I tried to send files from my mobile device to SyncDocs, but I can't find them.

To see if the issue has already been reported, please go to the bug reporting page at SF.net and use the Search box.

Starting SyncDocs in Troubleshooting Mode

If your issue is still not resolved, start SyncDocs in Troubleshooting mode. On Mac OS X, double click the file Troubleshoot.command in the same directory where SyncDocs is. On Windows, double click the file "Troubleshoot.bat". On Linux, double click the file "troubleshoot.sh" or change directories to that path in a terminal window and execute it.

Once in Troubleshooting mode, SyncDocs will print logging messages to a new Terminal or Command Prompt window (or to the same window if you've executed it directly). These will help us resolve your issue. If you're having a problem downloading files, then attempt to do that and copy and paste the output into a bug report at SF.net. If nothing is printed when you attempt to download files (or whatever it is that isn't working) please indicate that in your report.

The SyncDocs server never shows up in the list on my mobile device.
Bonjour can take up to 10 seconds to resolve. If you are trying different things to get it to work make sure you allow enough time for the resolve at each step.

  1. One or more firewalls may be preventing you from connecting. See the next section for more information about configuring your firewall(s).
  2. Make sure the Bonjour name you're using doesn't have any periods in it.
  3. Click the Setup button and verify that your wireless address is the one shown. If you're not sure, see the network interface help page.
  4. Make sure the computer running the SyncDocs server is on the same wireless network as the mobile device.
  5. Some users have reported problems with the iPhone client when it's plugged in via USB. Try disconnecting the iPhone from USB.
  6. For advanced network administrators that have a multilayered network, make sure the mobile device and computer running the SyncDocs server are on a directly connected network. Bonjour uses broadcasting for name resolution.
  7. If your problem is still not resolved, you may wish to try a version of SyncDocs that uses Apple's Bonjour code. If so, post your issue on the bug reporting page at SF.net and indicate that you would like to try that version.

It seems to take forever to upload or download files.
Please check your firewall settings.

Hardware Router or General OS Settings
  • Make sure your router is not filtering port 5353, which is the Bonjour port.
Mac OS X 10.4.11
  1. On the Mac that you will be syncing with, open the Sharing item in the System Preferences Control Panel: System Preferences>Sharing
  2. Click on the Firewall tab and then click on the "New" button.
  3. In the window that opens, click on the drop-down menu, and select "Other"
  4. Now in the box "TCP Port Number(s)" enter the same port number that is in the SyncDocs Setup. For the Description, type "SyncDocs". Click "OK"
  5. With the Firewall turned on, make sure that the SyncDocs item box is checked.
Mac OS X 10.5
  1. Start SyncDocs. SyncDocs will automatically select an unused port (with a preference for the port that was last used).
  2. In System Preferences (the Dock icon with gears), click Security (under Personal).
  3. Click on the Firewall tab.
  4. Click "Set access for specific services and applications" for the most secure available setting.
  5. Click the "+" button.
  6. A dialog opens where you can select the application you want to add. If you're not sure where SyncDocs is, type Command-Space to activate Spotlight, and type "SyncDocs" (without the quotes), then Command-Click the SyncDocs application in the list. A Finder window with SyncDocs will appear.
  7. Drag the SyncDocs application into the Security dialog.
  8. Click the "Add" button.
  9. Close the Security dialog.

I tried to send files to my mobile device but it says that it didn't find any files.
Make sure you have files that the application supports showing up in the main window of SyncDocs. See the
screenshots for how it should look. In this case, SyncDocs is ready to serve a "mm" file, or FreeMind mindmap file, to the next application that supports that file type. Mac OS X users, please make sure the file has an extension that is supported by the receiving application. Also make sure you are connecting to the right server by changing the Bonjour name that SyncDocs uses to something different from other web servers on your network. The Bonjour name can be changed by clicking the "Setup" button.

I tried to send files from my mobile device to SyncDocs, but I can't find them.
Make sure you're running at least version 0.3.4 of SyncDocs. That version introduced a "Show Downloads" button which will open a Finder window, Explorer window, or whatever is appropriate for your platform to the downloads directory. Make sure you are connecting to the right server by changing the Bonjour name that SyncDocs uses to something different from other web servers on your network. The Bonjour name can be changed by clicking the "Setup" button.


SourceForge Logo - Back To The SourceForge Main Page
SyncDocs is available under the GNU General Public License. SyncDocs is ©2008 Christopher Evans. Use the Contact Me link in the link bar to e-mail me.