What port does bliss run on? Can it be changed?

bliss is designed as a server application, presenting a Web UI through which you access its various features (on Windows, this appears to work like a usual foreground app, but in reality bliss is still running a background Web server, so this FAQ still applies). As a result it requires certain ports to be open on its host, so that external clients can make connections.

By default, there are two ports that must be opened:

Port 3220 is used to serve the Web UI. Port 3221 is also used by bliss's internal web server, exclusively for delivering debug related information as required.

Changing the ports

On rare occasions, if another piece of software has already taken the ports bliss uses by default, it is necessary to change the port numbers so bliss's web pages can be seen.

The first way of configuring which port to run on is to look for a file called config in the following location:

Windows XP C:\Documents and Settings\[username]\.bliss
Windows Vista, 7, 8 and 10 C:\Users\[username]\.bliss
Mac OS X (see below) /Users/[username]/Library/Preferences/bliss
Linux /home/[username]/.bliss
VortexBox /root/.bliss
Synology /var/packages/bliss/target/var/.bliss
QNAP `getcfg SHARE_DEF defVolMP -f /etc/config/def_share.info`/.qpkg/bliss/.bliss

If there's no such file there, create one.

Next, we need to make sure the following lines are in the file:


These change the web UI and debug UI ports to 5220 and 5221 respectively. You can leave either line out; in which case the default port is used for the line that is removed.

You must restart bliss after changing the file.

An alternative exists, and that is to set a system property. Follow the instructions at How can I assign more memory to bliss?, except instead of adding a "-Xmx" property, add -Dbliss.ui.port=5220 and/or -Dbliss.debug.port=5221.

A note for Mac users

Mac users may have trouble finding the Library folder. That's because this folder is hidden by default in more recent versions of OS X. There are a number of alternatives to make it visible but if this is just a one-off it may be easiest to use "Go to folder":

  1. Open Finder
  2. In the Go menu, click Go to Folder
  3. Enter: ~/Library/Preferences/bliss and click Go

You should now be able to see the folder in which to store the config file.

Outbound ports

For completeness it's worth mentioning outbound ports. Outbound ports are used where bliss makes a connection to an external service on the Internet, for example looking up cover art.

Outbound ports are short lived and assigned by the operating system and so are generally not controlled in the same static manner as inbound ports. More useful is a knowledge of which external services bliss connects to.

Any other FAQs I forgot or clarifications required? Post your ideas below!