search

YunoHost-Apps / syncthing_ynh

Syncthing package for YunoHost
https://syncthing.net/
Mozilla Public License 2.0
25 stars 5 forks source link

feature request: improve documentation on using foulders (safely) outside /home/yunohost.app/syncthing/ #156

Open ahcheing opened 1 year ago

ahcheing commented 1 year ago

I setup syncthing on my server, and as a user on that server I want to share a folder that I made in /home/yunouser/Documents/backup/ via syncthing. but it lacks permissions to that directory. how do I give syncthing permission to share the foulder in such a way that as a user I dont notice anything different then normal? (sorry if that did not make sense I can explain more if more clarifification need)

If on my laptop I share a foulder successfully via synthing to the yunohost server, how would yunouser on the server gain access to that foulder?

In regular syncthing on linux / windows both of those things are easy, but in yunohost I need to muck round with the permissions, which I am frankly unqualified to do absent some good instructions. I am not a sysadmin, I dont work in tech.

I know how to use chown and chgrp but I dont know how to add a user to a group (or rather, in the moment I can never remember if its usermod -aG user group or usermod -ag group user and if I screw that command up I've accidentally given a user a whole bunch of wrong permissions so I have to google / reference my notes every time I use it) and chmod numbersIcantremember foulder is too complicated for me since the numbers dont correspond easily with the output of ls -la.

All that is to say, since using syncthing in yunohost is pretty different then how its used normally, I think the documentation could use some updating.

If somone where to provide a simple explination in reply to this post for the two use cases I outlined, I could propably do pull request updating the readme with some formatted instructions.

(sorry bout spelling drafted this in a bit of a rush bout to go on vacation and all sorts of fun last minute things cropping up)

Pfeil commented 7 months ago

I agree this should be documented. In order to avoid breaking the existing setup somehow, I used the ACL instead of groups and users/owners. I think I did something like this (it has been a while):

sudo setfacl -Rm user:syncthing:rw /home/yunohost.multimedia/share

With this, the basic groups and owners stay as it is. Not sure if this is the best thing to do, but from my understanding, this is the minimal change we need to do to make it work. If people agree to this solution, if you add such an example to the app information shown in the yunohost app management interface, I think this issue would be solved.

agdamsbo commented 4 months ago

sudo setfacl -Rm user:syncthing:rw /home/yunohost.multimedia/share

So I have this same issue. I want to sync a folder in /home/yunohost.multimedia/share to a folder on a different machine. I keep getting errors trying to setup Syncthing to sync anything outside /home/yunohost.app/syncthing. I have tried your suggestion to edit the ACL only, no luck. I have also tried to add the syncthing user to the root group. No luck either. What to do? Thank you very much.

Pfeil commented 3 months ago

Are you sure you restarted syncthing after changing the ACL? If so, maybe there is any hint in the logs? It is still working for me. What does getfacl /home/yunohost.multimedia/share give you about the syncthing user?