Fork me on GitHub

“A personal music server
for everyone”

Command Line Options

Sockso has some extra command line options you can use to change the way it works. You pass these commands to Sockso by running it from the command line and with these options after the startup file (windows.bat or

Disables the GUI, this can be used to run Sockso on a server. You will be presented with a console to manage Sockso. Type help for a full list of the commands.

Tells Sockso where to store/look for all it's data. This can be used to to make Sockso portable for instance, by setting the data directory to wherever you want it to be. The (default) HSQLDB stores its data here, and cached cover images too.

Enable UPNP automatic port forwarding. On startup Sockso will try to forward the correct port from your UPNP enabled router. This requires the optionals package.

Sets the type of messages Sockso will output. "default" is the default and just produces the usual information about what Sockso is doing. "dev" can be used to provide much more detailed information.

--ip=(ip address)
Tell Sockso a fixed IP address to use (by default it'll try and work it out itself).

Here you can specify the language to use for the management interface (through the web interface Sockso will pick the language according to that specified by the users browser).

--query=(optional filename)
Specifies to run a query on the database and output the results as XML instead of starting Sockso. You can specify a file to read the SQL from, or Sockso will try to read the SQL from stdin.

This will tell Sockso whether to load it's resources from the jar file, or look on the filesystem in the resources folder (default).


Run Sockso using HTTPS instead of HTTP.

Specifies the location of a keystore to use for SSL

Specifies a password for the SSL keystore


The type of database to use. The MySQL and SQLite database require the optionals installed.

--dbhost=(DNS or IP)
The host for the database server

Database user

Database user's password

Name of the database to use

Prints out information about the command line options.


  • Kris said:
    Got it!

    Sorry ... my failure.

    Off course the command has too be executed like this:

    windows.bat --locale=en
    2014-05-13 10:48:01
  • rod said:
    Kris - the web interface always tries to serve the locale the browser specified - does your browser identify itself as your locale correctly?

    The --locale switch is just for the GUI.
    2014-05-13 10:45:43
  • Kris said:
    i can't set the locale information.
    I tried all in windows.bat an ended with this:

    start javaw -Djava.library.path="lib/std" -jar sockso.jar --locale=en %1 %2 %3 %4 %5


    start javaw -Djava.library.path="lib/std" -jar sockso.jar %1 %2 %3 %4 %5 --locale=en

    Both not working. I also renamed the locales-file, so my country-file is overwritten with the english information. This also did not work, it seemed that the pages are cached with the initial language-settings?! ... in ~"Documents and Settungs/{USER}/.sockso" i couldn't find anything concerning the locale-settings neither cached pages that could be deleted for a re-initialization.

    Any ideas? Thanks!
    2014-05-13 10:43:20

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