How To Install And Setup Jinzora Media Server In Ubuntu


If you have a huge collection of music and would like to build a media streaming server to manage your collection, then Jinzora is the right one for you.

Jinzora is a Web based media streaming and management system. It is supported in various platforms and it allows you to access your music collection from any devices over the Internet.

Installing Jinzora in Ubuntu


Before you can install Jinzora, you must set up a Web server first. If you have not done so, follow this tutorial to install LAMP on your Ubuntu machine.

Go to Jinzora and download the latest stable release for Linux/MacOS. (The current stable version is Jinzora 2.7.5)

Using Archive manager, extract the Jinzora2 folder to your home.

On the terminal (Applications -> Accessories -> Terminal), copy the Jinzora2 folder to the root of the Web server

Run the configure script to change the file permission

Next, install the required files.

Change php.ini setting

Some of the default setting in the php.ini did not meet the requirement of Jinzora2. We have to change it in order for Jinzora to work.

Search for

and change to the value to 64.

Search for

and change the value to 300

Search for

and change the value to 32

Search for

change the value to 32

Save and close the file. You are now set to install Jinzora

Installing Jinzora

1. Open your browser, point the URL to http://localhost/jinzora2

You will be greeted with Jinzora Welcome screen

alt=”jinzora-welcome-small” />

Below the page, click the ‘Proceed to Requirements‘ to continue the installation.

2. Jinzora will now check your system to see if it meets the minimum requirement. Since we have installed the necessary files and do the required configuration in the pre-installation, you shouldn’t have any issue in this step (or see any fields in red).


Click the ‘Proceed to License‘ to continue.

3. This will bring you to the license agreement page. Check the box and click the ‘Proceed to Install Type‘.


4. Under the Installation Type dropdown box, select Standalone.

Under the Jukebox Mode, choose Streaming Only. If you plan on running a server side Jukebox utilizing MPD, select Jukebox & Streaming (We won’t be covering that in this tutorial).


Click ‘Proceed to Main Settings‘ to continue.

5. Here is where you configure your Jinzora account.


Set up the admin login credential.

Under the ‘Backend‘ dropdown box, select Database.

Under the ‘Frontend‘ dropdown box, you can choose how the Jinzora looks like in the web browser. This is not a permanent setting and can be changed later on. For a start, just select ‘Slick’.

Import Settings define how Jinzora handles your media tracks. If you have been diligently organize your audio files in proper folder order, select ‘Filesystem‘ under Data Structure. On the other hand, if you have carefully enter the meta data for each tracks, but all the tracks are jumbled up in one folder, select ‘Tag data’ under Data Structure.

Under the Media layout, select how you want Jinzora to display your media files – by Genres, Albums or Artists.

Once done, click ‘Proceed to Backend Setup‘ to proceed


In the backend setup, enter your MySQL username and password in the ‘Database User‘ and ‘Database password‘ fields (this is the same data as the one you entered when you install LAMP on your system).

Give your database a name (In this case, I labeled it ‘jinzora2’. You can give other name though). Make sure that the Database Server is set to ‘Localhost‘, Database Type is ‘MySQL‘ and Create database is set to ‘True‘ (This is important! If you did not set the Create Database to True, Jinzora will not create a database and the whole installation will fail).

Click ‘Proceed With Backend Install

Jinzora will proceed to install the database. If everything is fine, it will show the Create Database successful screen.


There is nothing much to do in this page. Click ‘Proceed to import Media

7. In the Media Directory field, enter the file path to your media files. If you are not sure, click the ‘browse‘ button to locate your media folder. If you keep your media files at more than one location, don’t worry, you have a chance to import them all in the next step. Right now, just select one of the locations.


Click ‘Import Media’.

Depending on the number of media files you have, this importing process might take a long time.


If you still have media files scattered in other locations, enter the file path and click ‘Import Media‘, else, click ‘Proceed to Save Config‘.

8. You have come to the end of Jinzora installation.


Click ‘Proceed to launch Jinzora‘ to launch Jinzora.

9. Before you launch Jinzora, it will ask if you want to share your annonymous stats. This is purely optional. If you are kind enough, select the ‘Share annonymous stats’, else select ‘No, thanks‘.


Click ‘Launch Jinzora’. Don’t worry, we are getting there.

Post Installation

You will now see the Jinzora login screen. Login with your username and password.


In the next screen, you will see an error message requesting you to remove the Install directory.


Now, back to your terminal, type the following:

Once done, refresh your browser. You should be logged in to the Jinzora home page.


On the left pane lies all the configuration options. You can change the look and style of Jinzora via the Interface and Style setting located at the bottom of the left pane.


Access your Jinzora Web Media server from other computer

If you want to access Jinzora from an external terminal, either in a cybercafe or with your mobile PDA, you can reach it by pointing the URL to http://your-ip-address:8888/jinzora2. You will have to enable the 8888 port to make this works. If you are not sure how to enable the 8888 port, check out for detailed instructions.

Damien Damien

Damien Oh started writing tech articles since 2007 and has over 10 years of experience in the tech industry. He is proficient in Windows, Linux, Mac, Android and iOS, and worked as a part time WordPress Developer. He is currently the owner and Editor-in-Chief of Make Tech Easier.


  1. Hey,
    thank you really much for your tutorial. I have successfully set up Jinzora on a LAMP server, the only issue i have is that the streaming is very very slow. could someone help me?

    thank you very much,

  2. I am stuck on step 7 where it is not inporting my media files. does the extension have anything to do with?

  3. @idleone: Which folder did you place all your music? If they are not within your home folder, you might not be possible to import them due to permission issue.

  4. im stuck here…

    iceman600@UBUNTU-SERVER:~$ sudo cp jinzora2 /var/www
    sudo: unable to resolve host UBUNTU-SERVER
    cp: omitting directory `jinzora2′

    can you pls help me?

    i extract the file @ /home/iceman600 because i cannot extract it at /home
    i always got an error if i try to extract it at /home

  5. @iceman600: there is a conflict in your /etc/host file.

    In your terminal,

    gksu gedit /etc/hosts

    edit your entry to: localhost UBUNTU-SERVER

    Save and exit. Repeat the steps again. It should work

  6. after extracting the jinzora to /home/iceman600 i run this command on the terminal…

    sudo cp jinzora2 /var/www

    and got this error…

    iceman600@UBUNTU-SERVER:~$ sudo cp jinzora2 /var/www
    sudo: unable to resolve host UBUNTU-SERVER
    cp: omitting directory `jinzora2′

    i did the
    gksu gedit /etc/hosts

    edit your entry to: localhost UBUNTU-SERVER

    why i cant do ths? pls help me…

  7. this is what pops up when i do gksu gedit /etc/hosts localhost UBUNTU-SERVER.imeldapabon

    # The following lines are desirable for IPv6 capable hosts
    ::1 ip6-localhost ip6-loopback
    fe00::0 ip6-localnet
    ff00::0 ip6-mcastprefix
    ff02::1 ip6-allnodes
    ff02::2 ip6-allrouters
    ff02::3 ip6-allhosts

    is that right?

    ps: even if i drag the extracted jinzora2 file to /var/www igot an error not supported by backend

  8. damien… i cannot pass the first step on your tutorial.
    i cannot copy the jinzora2 to the /var/www
    it always ommiting the directory. the error is at the bottom. every time i type the
    “sudo cp jinzora2 /var/www
    i got this error.

    iceman600@UBUNTU-SERVER:~$ sudo cp jinzora2 /var/www
    cp: omitting directory `jinzora2′

    ps: and i did erase the .imeldapabon on the etc/host entry

    why cant i copy the jinzora2 to the /var/www folder?

  9. thank you so mch damien!!!
    i finally get it to work…
    its cool…
    does it transcode media files?

    thanks again for the help.
    your such a good man.

  10. what ip address will i type to stream with other pc?
    the ip address of the server? (UBUNTU-SERVER)

    or the ip of the localhost ( /etc/hosts

  11. ok i did it just a couple of wifi problem…
    when i acces it on my vista laptop and select a song it actually give me an option to download and it opens the media player to play the song. is that what it does really? i mean when you select a song it will open another media player for it to play?

    im sorry for asking to many questions…

  12. @iceman600: Yes, it will use the system default media player to play the music. This is how you configure your system to handle Web streaming, nothing to do with Jinzora.

  13. Hiya! Your guide has been the easiest to follow so far that I’ve found. Thank so much for posting! I was able to get everything running smoothly on my lappy…er…laptop, but am now trying to get it running on my boyfriend’s computer.

    There have been a few snags with his install though. Ultimately, I figured everything out except for when he tries to login…it comes up as invalid password.

    I know this is a silly question…but what command prompt would I use to uninstall jinzora2 completely so I could start new? There were so many snags, like I said, along the way of his install…I’m not sure where things went wrong, so I figured an uninstall would be the best thing. Maybe you know of another way?

    Thanks in advance!

  14. @nephilim11: To uninstall Jinzora, you simply have to delete the Jinzora2 folder and the database.
    sudo rm /var/www/Jinzora2. Go to http://localhost/phpmyadmin and delete away the Jinzora2 database. You can start afresh after that.

  15. Thank you for the quick response. =)

    I was able to come up with that on my own and get him logged in. I’m only a couple months in from making the full jump into linux, so I’m happy to see I got it right. w00t!

    Jinzora is still running a little quirky for uploading media from an external drive. His drive comes up, but no directories or files show up after that.

  16. Hi.. If you don’t mind a linux n00b question .. I used this guide but I’m running into a little trouble.. When I’m browsing for media files i go to /home/”user”/ and then it doesn’t see any folders. If i leave it like that and hit analyze it doesn’t gives an error that /var/www/jinzora2/install/browse.php has no access to view the files under that folder (access denied on line 52 of that script)
    The weird thing is that it has no trouble finding media on one of the ntfs partitions that i mounted from my windows hard drive (i have dual boot).. I have same media on both ntfs mounted partitions and ext3 partition in /home/”user”/Music.. So i wish i could use the music stored in my /home folder.. Any help with this is appreciated. (ignore any grammar errors please/I’m not a native English speaker)

  17. @etescartz

    I am having the same problem. my media is on a fat32 formatted external drive. when i try to import media from it, i get the same error:

    Warning: dir(/media/LACIE) [function.dir]: failed to open dir: Permission denied in /var/www/jinzora2/install/browse.php on line 52

    Anyone have any ideas why?

  18. Hi,

    I had everything working fine last night but now when i try to logon and play a file i get an invalid argument screen. I can download a file but cannot play… Anyone have a cleu as to why so that i might fix this? BTW awesome tut.

  19. hay i am haveing some permisions issues when i go to http://localhost/jinzora2/ it tells me that i don have permission to access this on the sever

  20. This is what the error i have says I dont know what to do.


    You don’t have permission to access /jinzora2/ on this server.
    Apache/2.2.11 (Ubuntu) PHP/5.2.6-3ubuntu4.1 with Suhosin-Patch Server at localhost Port 80

  21. If you have run the configure script as listed in the article, it should change the file permission.

    You might want to try the following command

    sudo chmod 755 /var/www/jinzora2

  22. Warning: Unknown: failed to open stream: Permission denied in Unknown on line 0

    Fatal error: Unknown: Failed opening required ‘/var/www/jinzora2/index.php’ (include_path=’.:/usr/share/php:/usr/share/pear’) in Unknown on line 0

    1. I get the same error, I’ve tried changing permissions on the jinzora folder and everything!

      1. I just did:
        sudo chown -R www-data:www-data jinzora2 (or whatever you named the folder)

        and it fixed it for me.

        1. For those of you still getting this message:
          Warning: Unknown(/var/www/jinzora2/index.php): failed to open stream: Permission denied in Unknown on line 0

          Try this:

          Go to the jinzora directory (is it /var/www/jinzora2 ?) and do:

          chmod -R a+rX .

  23. Streaming is probably slow due to your upload speed from your ISP. Might want to pay for a higher bandwith

Comments are closed.