IMO the standalone way of installation is the best for fast deployment. Tomcat is too heavy.

But the current documentation about the standalone installation doesn't have enough info to get it running properly like a daemon.

Some files are needed like systemd service files and start/stop scripts.

I currenlty have those but @muff1nman wanted to do this !

Centos 7 - Setup Guide

Install java 1.8 - openjdk

yum install java-1.8.0-openjdk.x86_64

Tomcat 8 setup:

• Create Tomcat user and group:

  sudo groupadd tomcat
  sudo useradd -M -s /bin/nologin -g tomcat -d /opt/tomcat tomcat	
  

• Install Tomcat 8:

  cd /tmp
  wget http://mirror.nohup.it/apache/tomcat/tomcat-8/v8.5.43/bin/apache-tomcat-8.5.43.tar.gz
  

  Info:

  • Tomcat website -> https://tomcat.apache.org/download-80.cgi
  • Download "Core" tar.gz

  sudo mkdir /opt/tomcat
  sudo tar xvf apache-tomcat-8*tar.gz -C /opt/tomcat --strip-components=1
  cd /opt/
  sudo chown -R tomcat. tomcat
  sudo chmod -R g+r conf
  sudo chmod g+x conf
  

• Systemd Unit:

  sudo vi /etc/systemd/system/tomcat.service

  Paste this:

# Systemd unit file for tomcat

[Unit]
Description=Apache Tomcat Web Application Container
After=syslog.target network.target
[Service]
Type=forking
Environment=JAVA_HOME=/usr/lib/jvm/jre
Environment=CATALINA_PID=/opt/tomcat/temp/tomcat.pid
Environment=CATALINA_HOME=/opt/tomcat
Environment=CATALINA_BASE=/opt/tomcat
Environment='CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC'
Environment='JAVA_OPTS=-Djava.awt.headless=true -Djava.security.egd=file:/dev/./urandom'
ExecStart=/opt/tomcat/bin/startup.sh
ExecStop=/bin/kill -15 $MAINPID
User=tomcat
Group=tomcat
UMask=0007
RestartSec=10
Restart=always
[Install]
WantedBy=multi-user.target

:wq
sudo systemctl daemon-reload

Install Airsonic:

sudo mkdir /var/airsonic/
sudo chown -R tomcat. /var/airsonic/

sudo mv airsonic.war /var/lib/tomcat8/webapps/airsonic.war
sudo chown tomcat. /opt/tomcat/webapps/airsonic.war

Start tomcat service:

sudo systemctl start tomcat.service

Info:

• Logs are stored in /opt/tomcat/logs/catalina.out

• Change default port:

  vi /opt/tomcat/conf/server.xml
  

  Change the Connector port="8080" port to any other port number:

   -->
      <Connector port="8080" protocol="HTTP/1.1"
                 connectionTimeout="20000"
                 redirectPort="8443" />
      <!-- A "Connector" using the shared thread pool-->
      <!--
  
  

  For example

   -->
      <Connector port="9999" protocol="HTTP/1.1"
                 connectionTimeout="20000"
                 redirectPort="8443" />
      <!-- A "Connector" using the shared thread pool-->
      <!--
  
  

Issue by jooola
Saturday May 27, 2017 at 04:22 GMT
Originally opened as https://github.com/Libresonic/documentation/issues/9

Issue by jooola
Sunday May 21, 2017 at 01:14 GMT
Originally opened as https://github.com/Libresonic/documentation/issues/5

We need to provide the API documentation or at least a link to the subsonic API documentation page !

Issue by CharlesSchaack
Thursday May 18, 2017 at 19:50 GMT
Originally opened as https://github.com/Libresonic/documentation/pull/4

I noticed none of these links are working after the names were switched to lowercase. I see you guys are working on drawing up comprehensive documentation but I just wanted to fix this while it still exists.
Signed-off-by: Charles Schaack [email protected]

CharlesSchaack included the following code: https://github.com/Libresonic/documentation/pull/4/commits

The page:

https://github.com/airsonic/documentation/blob/master/docs/transcode

gives a 404 error.

Thank you.

We need to add some more notes about some specific hardware or situation, using a FAQ or some notes here and there

Wasn't sure if you wanted this reported in here or airsonic.github.io - but your link from the Migrate page needs to be fixed. https://airsonic.github.io/docs/install/ gives a 404 (found on the Migrate page under "Install Airsonic as described in the install guide.") because there is no install.md in the /pages/ directory on the airsonic.github.io repo.

I followed the instructions found here -> https://airsonic.github.io/docs/developer/intellij/, however the application would not start. Instead I got the following exception;

org.springframework.context.ApplicationContextException: Unable to start embedded container; nested exception is org.springframework.boot.context.embedded.EmbeddedServletContainerException: Unable to start embedded Tomcat
	at org.springframework.boot.context.embedded.EmbeddedWebApplicationContext.onRefresh(EmbeddedWebApplicationContext.java:138) ~[spring-boot-1.5.22.RELEASE.jar:1.5.22.RELEASE]
	at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:536) ~[spring-context-4.3.25.RELEASE.jar:4.3.25.RELEASE]
	at org.springframework.boot.context.embedded.EmbeddedWebApplicationContext.refresh(EmbeddedWebApplicationContext.java:123) ~[spring-boot-1.5.22.RELEASE.jar:1.5.22.RELEASE]
	at org.springframework.boot.SpringApplication.refresh(SpringApplication.java:666) ~[spring-boot-1.5.22.RELEASE.jar:1.5.22.RELEASE]
	at org.springframework.boot.SpringApplication.refreshContext(SpringApplication.java:353) ~[spring-boot-1.5.22.RELEASE.jar:1.5.22.RELEASE]
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:300) ~[spring-boot-1.5.22.RELEASE.jar:1.5.22.RELEASE]
	at org.springframework.boot.builder.SpringApplicationBuilder.run(SpringApplicationBuilder.java:135) [spring-boot-1.5.22.RELEASE.jar:1.5.22.RELEASE]
	at org.airsonic.player.Application.main(Application.java:222) [classes/:na]
Caused by: org.springframework.boot.context.embedded.EmbeddedServletContainerException: Unable to start embedded Tomcat
	at org.springframework.boot.context.embedded.tomcat.TomcatEmbeddedServletContainer.initialize(TomcatEmbeddedServletContainer.java:135) ~[spring-boot-1.5.22.RELEASE.jar:1.5.22.RELEASE]
	at org.springframework.boot.context.embedded.tomcat.TomcatEmbeddedServletContainer.<init>(TomcatEmbeddedServletContainer.java:87) ~[spring-boot-1.5.22.RELEASE.jar:1.5.22.RELEASE]
	at org.springframework.boot.context.embedded.tomcat.TomcatEmbeddedServletContainerFactory.getTomcatEmbeddedServletContainer(TomcatEmbeddedServletContainerFactory.java:535) ~[spring-boot-1.5.22.RELEASE.jar:1.5.22.RELEASE]
	at org.springframework.boot.context.embedded.tomcat.TomcatEmbeddedServletContainerFactory.getEmbeddedServletContainer(TomcatEmbeddedServletContainerFactory.java:177) ~[spring-boot-1.5.22.RELEASE.jar:1.5.22.RELEASE]
	at org.springframework.boot.context.embedded.EmbeddedWebApplicationContext.createEmbeddedServletContainer(EmbeddedWebApplicationContext.java:162) ~[spring-boot-1.5.22.RELEASE.jar:1.5.22.RELEASE]
	at org.springframework.boot.context.embedded.EmbeddedWebApplicationContext.onRefresh(EmbeddedWebApplicationContext.java:135) ~[spring-boot-1.5.22.RELEASE.jar:1.5.22.RELEASE]
	... 7 common frames omitted
Caused by: java.lang.NullPointerException: null
	at java.io.SequenceInputStream.nextStream(SequenceInputStream.java:112) ~[na:1.8.0_152]
	at java.io.SequenceInputStream.read(SequenceInputStream.java:211) ~[na:1.8.0_152]
	at java.io.SequenceInputStream.read(SequenceInputStream.java:207) ~[na:1.8.0_152]

I was able to move past this error by setting the following system property;

-Dairsonic.development=true

Just curious if anyone knew where the source code for this was, since their website (substreamerapp.com) seems to be down? It's a great app but if we can't find source code, it should be marked it as non-free in apps/docs.md.

The airsonic.war file is signed by my GPG key in a signature file in the github release files (i.e. https://github.com/airsonic/airsonic/releases/download/v10.2.1/airsonic.war.asc). We should update the downloads to include links to the signature files and we should update the docs to provide instructions for verifying the downloaded file with GPG.

Example :

airsonic/airsonic#557

Currently the proxy documentation provide configuration but they aren't complete !

For example the apache configuration only work for HTTP and not HTTPS !
Nginx configuration only works for HTTPS not with HTTP.(SSL should be default but still ...)

Issue by qlyoung
Monday Jul 03, 2017 at 03:40 GMT
Originally opened as https://github.com/Libresonic/documentation/issues/12

Per my comment on libresonic/libresonic#281, issues with extremely long deployment times under OpenJDK are not limited to Raspbian / *Pi platforms but in fact appear to be caused by OpenJDK under any Jessie + ARM platform. It looks like the response to that issue was to add an installation guide for Raspbian that simply noted that Oracle's JRE should be used on that platform (#10).

While helpful, since this problem appears to affect all ARM platforms (at least under Jessie), I believe the problem itself should be explicitly documented along with the appropriate workaround. Among other things this will improve google-ability; I was on the verge of giving up and resorting to the crappy adware subsonic deb because it Just Worked ™️

Unless core devs object to this I'll open a pull request to this effect when I have some spare time.

See the second example missing X-Forwarded-Host

Someone asked me what is the minimum configuration required to run airsonic.

I know that a raspi3 is waaaaaaaay more than enough, but what about other popular devices, like a raspi zero?

my latest PR has been merged, but the changes are sill not reflected on website docs
https://airsonic.github.io/docs/apps/

Airsonic release 10.0.0 added official docker image.

Documentation should be also updated with how-to install and run Airsonic in docker container.

Issue by biconou
Friday May 12, 2017 at 21:15 GMT
Originally opened as https://github.com/Libresonic/documentation/pull/1

biconou included the following code: https://github.com/Libresonic/documentation/pull/1/commits

I think it would be a good idea to rename this repo to airsonic-docs, so that it is clear from the name where it came from when people fork it, and to avoid conflicting with other documentation projects. documentation is way too generic.

I am running Airsonic 10.4 on ubuntu server 18.04 LTS. At the time of setting it up, everything was fine, I even shared several albums through airsonic share link, but suddenly, without apparent reason, the share link disappeared. I first thought it could be resolved after updating airsonic to the latest version (because I originally installed Airsonic 10.2), but it did not. I try to gather some information here and there on internet, but it seems I'm pretty lonesome. I have openjdk-8-jre installed as required, so I'm a bit lost. Have you ever seen this before ? Or am I missing something, somewhere ? Thank you

We need to have a documentation on how to set up the jukebox mode.

Issue by jooola
Saturday May 27, 2017 at 04:23 GMT
Originally opened as https://github.com/Libresonic/documentation/issues/10

See https://github.com/Libresonic/libresonic/issues/281

I am running airsonic in a Docker container with URL base set as airsonic.

CADDYFILE

• Internal access to localhost only works when "without /airsonic" is used

https://mydomain.net/ http://localhost/ {
    proxy / 192.168.1.103:4040/airsonic {          # https://github.com/airsonic/airsonic
    transparent
	without /airsonic
  }
}

https://mydomain.net gets redirected to http//mydomain.net after I provide valid user name and password. Seems like Airsoni is redirecting HTTPS traffic to HTTP which is not configured in Caddy or allwed through the firewall.

Hoping I am missing something simple.

Airsonic log file
airsonic.log

Issue by muff1nman
Tuesday May 23, 2017 at 03:13 GMT
Originally opened as https://github.com/Libresonic/documentation/pull/7

muff1nman included the following code: https://github.com/Libresonic/documentation/pull/7/commits

I followed the exact Dodumentation from: https://airsonic.github.io/docs/install/docker/
I found one Error.

Wrong: You should be able to access Airsonic on http://localhost:4040 after a couple of seconds.
Right: You should be able to access Airsonic on http://localhost:4040/airsonic after a couple of seconds.

Issue by jooola
Monday May 22, 2017 at 17:56 GMT
Originally opened as https://github.com/Libresonic/documentation/issues/6

https://www.reddit.com/r/libresonic/comments/4r2wg0/fail2ban_and_libresonic/

When running airsonic behind a reverse proxy with restrictive Content-Security-Policy settings the example config mentioned in the documentation may not be enough.

I had to add the following line to my nginx configuration for airsonic, to get it running without errors:

add_header Content-Security-Policy "default-src 'self'; script-src 'self' 'unsafe-inline' 'unsafe-eval' www.gstatic.com; img-src 'self' *.akamaized.net; style-src 'self' 'unsafe-inline' fonts.googleapis.com; font-src 'self' fonts.gstatic.com; frame-src 'self'; object-src 'none'";

The documentation should be more specific on what has to be allowed and what may be restricted.

Issue by jooola
Saturday May 27, 2017 at 04:21 GMT
Originally opened as https://github.com/Libresonic/documentation/issues/8

Source:
https://airsonic.github.io/docs/install/example/raspberrypi/

Section:
"Set up a reverse proxy"

Documentation says:
proxy_set_header X-Forwarded-Host $host;

-> wrong, since playing songs and showing cover art is broken

Correction:
proxy_set_header X-Forwarded-Host $http_host;

Issue by biconou
Saturday May 13, 2017 at 16:34 GMT
Originally opened as https://github.com/Libresonic/documentation/pull/2

This documentation is valid from 6.2 version.

biconou included the following code: https://github.com/Libresonic/documentation/pull/2/commits

Issue by jooola
Sunday May 28, 2017 at 19:25 GMT
Originally opened as https://github.com/Libresonic/documentation/issues/11

I don't know if some others made this already but it have some files to run libresonic.war as standalone using systemd on Debian/Ubuntu systems.

We could provide files like those right ?

I think i'm going to build a deploy script that create the libresonic /varlibresonic folders, download the package, deploy it using the standalone verion, and finally setup a systemd daemon control

If anyone want to add some details to my files please tell me !

@muff1nman I know you have some scripts would you share some of them ? What do you think ?

From matrix community channel

I'm trying to install airsonic. What exactly is the difference of tomcat vs non-tomcat? (except for the end URL)?

We need to document this comparison and suggest either one depending on each situation

Hi Everyone,

It's been a while, as previously requested, I have opened a new issue to get substreamer added back into the list of available apps for airsonic.

New website is up and running:
https://substreamerapp.com/

App is available for both Android and iOS with a huge update just released to both stores this week. I know I've been quiet for a while but I have been working on substreamer in the background and using the various betas myself and finally got everything together and properly released again!

Issue by muff1nman
Saturday May 13, 2017 at 20:55 GMT
Originally opened as https://github.com/Libresonic/documentation/pull/3

muff1nman included the following code: https://github.com/Libresonic/documentation/pull/3/commits

in windows installation guide:
https://airsonic.github.io/docs/install/windows/#installing-airsonic-as-windows-service

line:
Arguments = -Dairsonic.home="C:\\Program Files\\Airsonic" -Dserver.port=4040
should be:
Arguments = -Dairsonic.home="C:\\Program Files\\Airsonic" -Dserver.port=4040 -jar airsonic.war
or service isn't start