Troubleshooting

Q: I get an 'Update failed' message after installing an update, and now the UI no longer works. What should I do?

If an auto-update fails, you can usually restore functionality by simply reinstalling OneSwarm (from a downloaded installer). This won't delete your files, friends, or change your key.

Q: I get a 404/file not found error when OneSwarm starts. What's the problem?

OneSwarm requires that your browser support cookies (at least session cookies) and Javascript. If you're using a modern browser, check your security settings and disable any add-ons (e.g., NoScript) for the OneSwarm web UI address: 127.0.0.1:29615. Note that localhost:29615 does not work as a substitute for 127.0.0.1:29615; you must use the IP address.

Q: Why isn't my download starting?

• The user(s) sharing the data are offline
• The user(s) sharing the data are already using their full capacity while sharing other swarms
• There is no path in the friend-to-friend network between you and the user(s) sharing the data

Q: Why can't I connect to friends?

• Your friend is offline.
• You have added your friend, but your friend has not accepted your friend request.
• Your friend is unreachable, possibly because of because of NAT / firewall issues. OneSwarm automatically opens ports on many routers that support UPnP, but OneSwarm works best when you manually configure port forwarding to the TCP/UDP ports specified in the OneSwarm settings. See [http://azureuswiki.com/index.php/NAT_problem this page] for more information on forwarding ports on common routers.

If you are certain that your friend is online but OneSwarm was not able to connect normally during startup (and you'd rather not wait for the periodic reconnection attempt), you can force a connection attempt to be made to individual friends by clicking the 'Force connect' button in the friend's information panel, shown below.

Q: Why doesn't preview generation and in-browser playback doesn't work on 64 bit Linux?

OneSwarm requires 32 bit support libraries which are bundled by many, but not all, 64 bit distributions. Otherwise, you'll need to install them, e.g.,

sudo apt-get install ia32-libs

Q: Is there a headless OneSwarm client?

Not yet, but we're working on adding this. In the meantime, the virtual framebuffer X server Xvfb allows you to run OneSwarm sending the graphics output to a dummy Xserver. (Thanks to forum member juran for pointing this out)

Xvfb :1 && env DISPLAY=:1 OneSwarm

Issue: OneSwarm doesn't work in multi-user environments.

This is a known bug. OneSwarm does not work with multiple concurrent users on the same machine since any local user can access the OneSwarm web UI on its default port. We are currently working on a fix for this issue.

If all else fails:

1. Restart your OneSwarm client.
2. If problems persist, delete your downloads.config and downloads.config.bak files in the OneSwarm settings directory and the permissions.xml file. On Windows, the settings directory is in your user home directory\App Data\Roaming\OneSwarm. On Macs, it's in your home directory/Library/Application Support/OneSwarm. On linux, it's in your home directory/.oneswarm. This will remove all download information from OneSwarm, but won't delete files from your computer.
3. If deleting the downloads.config doesn't solve the problem, you should try deleting all settings files in the OneSwarm settings directory exception the osf2f directory (osf2f contains your identity and information for connecting to friends).
4. If neither of the above work, back up your osf2f settings in the OneSwarm settings directory, uninstall and reinstall the software, and restore your osf2f directory.