airsonic / airsonic-docs Goto Github PK
View Code? Open in Web Editor NEWDocumentation for the Airsonic project
License: GNU General Public License v3.0
Documentation for the Airsonic project
License: GNU General Public License v3.0
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 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 !
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.
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
.
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
I am running airsonic in a Docker container with URL base set as airsonic.
CADDYFILE
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
The page:
https://github.com/airsonic/documentation/blob/master/docs/transcode
gives a 404 error.
Thank you.
We need to have a documentation on how to set up the jukebox mode.
Airsonic release 10.0.0
added official docker image.
Documentation should be also updated with how-to install and run Airsonic in docker container.
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
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 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
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?
Example :
Issue by jooola
Saturday May 27, 2017 at 04:21 GMT
Originally opened as https://github.com/Libresonic/documentation/issues/8
We need to add some more notes about some specific hardware or situation, using a FAQ or some notes here and there
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.
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;
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
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.
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!
yum install java-1.8.0-openjdk.x86_64
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
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
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-->
<!--
See the second example missing X-Forwarded-Host
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
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
Issue by jooola
Saturday May 27, 2017 at 04:23 GMT
Originally opened as https://github.com/Libresonic/documentation/issues/10
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
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 !
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
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 ?
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
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.
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.
Issue by jooola
Saturday May 27, 2017 at 04:22 GMT
Originally opened as https://github.com/Libresonic/documentation/issues/9
my latest PR has been merged, but the changes are sill not reflected on website docs
https://airsonic.github.io/docs/apps/
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/
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.