Skip to content
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

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

trommegutten
Copy link

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:

  1. 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.

  2. 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.

  3. License Acceptance All contributions must be licensed under GNU GPLv3 to be accepted. Use git commit --signoff to acknowledge this.

  4. Be bold! Without contributions, this project will vanish.

  5. 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.

I have updated the manual after installing airsonic on my FreeNAS 11.3.
Copy link
Contributor

@fxthomas fxthomas left a 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.
Copy link
Contributor

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
Copy link
Contributor

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)
Copy link
Contributor

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).
Copy link
Contributor

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)?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants