-
Notifications
You must be signed in to change notification settings - Fork 48
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Update freebsd_freenas.md #88
base: master
Are you sure you want to change the base?
Conversation
I have updated the manual after installing airsonic on my FreeNAS 11.3.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good to me aside from a couple comments, thanks for the help! 😄
It sounds like this is specific to a FreeNAS/FreeBSD release : can you mention that at the top of the file?
``` | ||
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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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!
|
||
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 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nit: Missing '.'
|
||
Then Stop the jail and mount your media folder to the jail (Jails>Mount Points) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nit: Missing '.'
# 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). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
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)?
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 (# h1
or## h2
headers).- 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 --signoff
to 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.