Fork me on GitHub

“A personal music server
for everyone”

Installing Sockso

First thing you'll need to do is download Sockso. You can get the latest version from here. It's a ZIP file, so unzip it somewhere on your computer where you'll keep Sockso.

And that's it! Sockso doesn't need an installer, it just runs right away! So when you've got that done you can move on to running sockso.


The only thing Sockso requires is that Java is installed on your machine. Java has become pretty ubiquitous so you're almosty garaunteed to have it. If you don't then you can go download the latest version for free from here..


NOTE: Sockso is not currently compatible with GCJ, it requires a Sun Java runtime.


  • Mokus said:
    The Run Sockso file looks for the program according to an older version's directions. Meaning if you don't have your files in the right place, Sockso will look in the wrong place. You need to put all your files in the place where Sockso is looking for them per the error. Kind of sloppy, but I was able to clean it up.

    Now I need to figure out why at the end of playing one song, it doesn't start playing the next automatically.
    2015-03-10 15:32:48
  • ryan said:
    For MAC - you'll need to allow 'apps from anywhere' in the Security(General) settings to allow Sockso to be mounted. I have it running on OS X Yosemite, albeit slow.
    2015-02-17 21:13:56
  • Alex said:
    I have the same problem than Jeff... It's damaged for Mac 10.9.1. Anyone succeeded to make it work on mac ?
    2013-12-30 00:37:50
  • foamdelta said:
    hi. as a newbie to this software .. is there a way i can test it .. "as if " i was a friend login in? i see at the bottom of the console theres a address. if i click there i get "page cant be displayed".
    sorry i am new to this .. ive loaded some folders .. lots of music and if i login as admin it all looks fine.? playlists everything.
    the other thing that makes me think its not working right is im not showing in the "community" list.
    im starting to think im just viewing the stuff on my laptop. help
    2013-10-28 11:19:01
  • Jeff said:
    Hello, I'm really excited to try this software, but when I open it I get a message saying it's damaged and to move it to the trash. I'm on a Mac OS 10.8.5 any help would be appreciated. thanks
    2013-10-20 17:20:15
  • 4people2purple_roses said:
    Hallo, wie k├Ânnen die Gefehle in der Console benutzt werden.
    Egal welcher Art der Eintrag, z.b. coladd Path
    eingegeben wird - es passiert nichts.
    Bitte um Hilfe

    thx 4people2purple_roses
    2013-10-12 13:13:37
  • Paul said:
    Josh, I have an update about Sockso w/OpenJDK 6 and the Raspberry Pi. I emailed Rod and he gave me an idea to try and it worked. There are only 2 issues to be concerned with.
    1. Sockso takes 4-10 minutes to load depending on your music archive size (I have a huge archive). But once Sockso loads up it actually works good.
    2. Indexing your music can take from 1 - ??? days depending once again on the size of your music archive. Rod's trick is to index on a faster PC and then copy the ".sockso" folder (Database) to the Pi after it has completed.
    2013-05-22 04:44:01
  • Paul said:
    Josh...Don't bother trying to get Sockso running on Raspberry Pi I have tried and the biggest set back is that Java is very slow booting up and if you have a large music archive like I have then it will take forever to index it all. I am looking into alternatives right now.
    2013-05-14 14:33:10
  • Josh said:
    Just want to confirm this works on a Raspberry Pi (model B revision 2 [512MB RAM]).
    2012-12-15 21:32:11
  • racso said:
    for give me

    i dont know but i think so is working because ask me collection and open java
    2012-12-10 08:36:23
  • racso said:
    hey :
    how can i must to install this over W7 home premium

    thanks if you answer soon
    2012-12-10 08:26:09
  • Alex said:
    Hi, Sockso is really wonderful! Many thanks for you guys, :D
    Btw, is that possible to host Sockso in my own web-hosting server, like bluehost ?
    2012-05-11 16:05:35
  • GunWi said:

    It works for me, so look at your lokal settings... is right: just a double click - and sockso cames up.
    On more than 3 machines, without any problem.
    2012-02-22 08:52:29
  • name (optional) said:
    readme says: To run Sockso under Windows just double click "Run Sockso". Easy!

    I could easily name 9 out of 10 poeple who will simply delete it after the first attempt of getting it started since that above statement is stimply wrong, as it's always wrong since anything to do with java on a windows system leads to errors in 99% of all cases.

    Can't find windows.bat, can't find javvaw even if located in same folder ... java worse but if none would have invented computers at all

    Once it works it's a jolly good piece of software. Compare to other attempts it really does the tricky far better and easier. Wonder why the rest did it so much more complicated.
    2012-02-09 04:26:05

Post Comment

Just enter your name, fill out the easy captcha and enter your comments - it'll appear on the site right away. If you enter your email it will just be linked from your name so people can get in touch with you about your comment, so it's optional.

Sockso Community!

Sockso comes with the ability to be instantly part of the Sockso Community. So install now to to take part!

If you love using Sockso and would like to give a little back, try a donation to help out and support open source development.

Latest News & Releases RSS Icon

12th May

Sockso 1.5.3 - Bug fix release - fixes broken folder browsing and related artists.

29th April

Sockso 1.5.2 - Bug fix for broken local cover art, and updated French translation.

14th March 2012

Sockso 1.5.1 - Bug fixes for path security hole, API access, and encoded pluses. Along with updated Italian translation, adding ability to extract cover art from ID3 tags.

10th December

Sockso 1.5 - Added ability to add arbitrary meta tags, JPlayer support, HTTP Range header support, bug fixes, and finalised API v1.0

25th July

Sockso 1.4.2 - Fix for fetching cover artwork from Amazon.

24th July

Sockso 1.4.1 - Fixes for unicode output issue, and strict JSON API issue with single quotes.

23rd July

Sockso 1.4 - Added a JSON API to support developing applications on top of Sockso.

8th July

Posted screencast of *VERY* early version of new Sockso iPhone app. Feedback appreciated in the forums.

2nd July

Sockso 1.3.5 - Fix for problem on OSX where Sockso would not start, other minor bug fixes for Flac handling.

26th June

Sockso 1.3.4 - New HTML5 Player for iPad/iOS/etc support from nguillaumin, new 'tinygreen' skin from Simplify, and some bug fixes.

4th May

Sockso 1.3.3 - Album years now shown, Turkish translation added, and MP3 tag library updated (all thanks to badZeppelin!), some bug fixes to ajax page loading.

2nd April

Sockso 1.3.2 - Users can now require approval when registering, and updated ajaxified web interface with embedded player now default.

23rd March

Sockso 1.3.1 - Fix for missing 'colscan' command from console, moved optional libraries location (to upgrade rename your optionals folder from 'lib-opt' to 'lib/opt', and a bug fix for invalid URL characters breaking some playlist files.

17th March

Sockso 1.3 - Created ability to add servers to the new Sockso Community, and you can now run behind Apache without needing a VirtualHost (thanks to LightGlitch!)

5th February

Sockso 1.2.7 - Fix for broken javascript in 1.2.6.

30th January 2011

Sockso 1.2.6 (broken) - Fix for selecting the playlist in some browsers, and added new web admin console.

17th December

Sockso 1.2.5 - Minor bug fix for adding items to the playlist when browsing folders.

10th April

Sockso 1.2.4 - Patches from Will to improve HTTP/HTTPS streaming performance, and HTML compliance, improved music tree in GUI to cope with any size collections, hidden files now ignored on indexing, and some other bugs.

8th February

Sockso 1.2.3 - Fixed broken 1.2.2 release.

Linux Logo Windows Logo OSX Logo