Open
Conversation
I have updated the manual after installing airsonic on my FreeNAS 11.3.
fxthomas
reviewed
Apr 14, 2020
| ``` | ||
| Add the line *<Context docBase="airsonic" path="" reloadable="true" />* below the element, before the | ||
| </Host> tag; then save: | ||
| Goto line 154 and add *<Context docBase="airsonic" path="" reloadable="true" />* below the element; then save. |
Contributor
There was a problem hiding this comment.
My gut feeling is that it's much more future-proof to provide instructions for finding the line (possibly optionally with the line number) in case this changes. This will help for the next update!
| #### Mount media directories in jail (FreeNAS) | ||
|
|
||
| If you are using FreeNAS, you will mount your media files using the FreeNAS gui. | ||
| First be aware that you have enabled group access to your media pool dataset |
| First be aware that you have enabled group access to your media pool dataset | ||
| In FreeNAS gui goto Storage>Pools, choose your media pool and choose "Edit ACL". | ||
|
|
||
| Then Stop the jail and mount your media folder to the jail (Jails>Mount Points) |
| # ls -l /var | ||
| drwxrwx---+ 321 nobody 1000 322 Apr 4 20:32 music | ||
| ``` | ||
| Notice that the music folder is accessible by group 1000 in this case, so we need to add the user "www" to this group to have group access to the folder. The groupID 1000 is actually from outside the jail, so we first need to make a corresponding group inside the jail (you need to change 1000 to the correct groupID in your setup). |
Contributor
There was a problem hiding this comment.
I don't run FreeBSD, but what if the group 1000 already exists (from where I stand it's a fair assumption, it's the default user group in many Linux distributions)?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
I have updated the manual after installing airsonic on my FreeNAS 11.3.
Guidelines for Contributing
Airsonic development is a community project, and contributions are welcomed. Here are a few guidelines you should follow before submitting:
Styling The documentation follows some styling guidelines to fit with the website.
- Follow the markdown guidelines. For more details see this guide.
- Do not use
<h1>or<h2>headers (# h1or## h2headers).- Never manually start a new line in the middle of a sentence.
- More spacing, more empty lines !! The documentation needs to be readable !
- Read existing guides to find some inspiration.
Testing The documentation is browsed with the website, so we recommend to test any new guides within the website using jekyll locally.
- Clone the website repo
git clone https://github.com/airsonic/airsonic.github.io.- Change directory into the cloned repo
cd airsonic.github.io.- Clone the documentation submodule
git clone https://github.com/airsonic/documentation pages/docs.- Install Jekyll
- Run
jekyll serve --watch.- Add your changes.
- Check if everything is fine at
localhost:4040.License Acceptance All contributions must be licensed under GNU GPLv3 to be accepted. Use
git commit --signoffto acknowledge this.Be bold! Without contributions, this project will vanish.
Stay relevant Issues or commentary that is off-topic or tangential to Airsonic development is subject to moderation. Questions should be focused on improving documentation to solve a problem. Visit Reddit or IRC for community discussion.