Install instructions for stable branch

master
Eugene E. Kashpureff Jr 9 years ago
parent 8cd951f9a7
commit debd7aa6fb
  1. 64
      INSTALL.md

@ -2,65 +2,7 @@
# INSTALL.md # INSTALL.md
# Libresonic/libresonic # Libresonic/libresonic
--> -->
Requirements Libresonic Installation
------------ -----------------------
* Recent version of [Maven](http://maven.apache.org/).
* A JDK installation. 1.7.x series of OpenJDK or Oracle JDK 7+ should work.
* Optional: lintian and fakeroot, for .deb package
* Test as follows:
```
$ which mvn
/usr/local/bin/mvn
$ echo $JAVA_HOME
/usr/lib/jvm/java-1.7.0-openjdk.x86_64
$
```
Now you can clone a copy of this repository:
```
$ git clone git://github.com/Libresonic/libresonic.git
$ cd libresonic
$
```
Standalone WAR
--------------
At this point you are ready to build the basic Subsonic WAR. This is required for all the other build targets, so you should do it before proceeding.
```
$ mvn package
<lots of buildspam>
[INFO] Building war: /path/to/repo/subsonic/subsonic-main/target/subsonic.war
<more buildspam>
$
```
Tomcat Installation
-------------------
The WAR may be copied directly to a Tomcat server's webapps/ directory and deployed.
```
$ cp subsonic-main/target/subsonic.war /var/lib/tomcat6/webapps/
$
```
Packaged .deb
-------------
You can furthermore go ahead to create a .deb suitable for installation on Debian or Ubuntu. These instructions should similarly work with rpm(for RedHat/CentOS or Fedora), but it is has not been tested.
```
$ mvn -P full -pl subsonic-booter -am install
$ mvn -P full -pl subsonic-installer-debian/ -am install
$ sudo dpkg -i ./subsonic-installer-debian/target/subsonic-*.deb
$
```
Good luck!
At present, building from the `stable` branch is not recommended. See the `develop` branch for more information. You can download the [Stable WAR](https://github.com/Libresonic/libresonic/releases) and [deploy using Tomcat](https://tomcat.apache.org/tomcat-8.0-doc/deployer-howto.html).

Loading…
Cancel
Save