65 lines
2.3 KiB
Plaintext
65 lines
2.3 KiB
Plaintext
$OpenBSD: README,v 1.4 2018/09/04 12:46:19 espie Exp $
|
|
|
|
+-----------------------------------------------------------------------
|
|
| Running ${PKGSTEM} on OpenBSD
|
|
+-----------------------------------------------------------------------
|
|
|
|
Compatibility
|
|
=============
|
|
|
|
Please note that not all versions of Syncthing are compatible. The
|
|
second number in the release string must match. E.g. 0.12.x is not
|
|
compatible with 0.13.x. If you mismatch the versions, hosts will fail to
|
|
discover each other.
|
|
|
|
Starting Syncthing
|
|
==================
|
|
|
|
There are a couple of different ways to invoke Syncthing. Which is best
|
|
for you will depend upon how many users will run Syncthing concurrently.
|
|
|
|
Starting via RC script
|
|
----------------------
|
|
|
|
Syncthing can be started via the included RC script, thus running
|
|
Syncthing as a system service. This is fine for single user
|
|
configurations. Under this mode of operation, Syncthing will run as the
|
|
_syncthing user and store the default 'Sync' folder under
|
|
${VARBASE}/syncthing.
|
|
|
|
Starting Manually
|
|
-----------------
|
|
|
|
The other way is to simply invoke ${TRUEPREFIX}/bin/syncthing manually.
|
|
This is a better choice for situations where several users all want to
|
|
run their own instances of Syncthing. Under this mode, the default
|
|
'Sync' folder will be stored in the user's home directory. Users will
|
|
have to configure Syncthing to listen on different TCP ports for this
|
|
method to work.
|
|
|
|
It might be desirable to have Syncthing executed on system reboot for
|
|
each user individually. To achieve this a crontab entry can be created
|
|
on per-user basis:
|
|
|
|
@reboot tmux new-session -d '${TRUEPREFIX}/bin/syncthing'
|
|
|
|
This will result in a new tmux(1) session being spawned each system
|
|
boot. The user can later use `tmux attach` to view and control their
|
|
Syncthing process.
|
|
|
|
File Descriptor Limits
|
|
======================
|
|
|
|
Syncthing is fairly hungry for file descriptors and the default limits may be
|
|
insufficient. If you run Syncthing via the rc.d(8) script, then you can give
|
|
Syncthing more file descriptors by adding the following to login.conf(5):
|
|
|
|
syncthing:\
|
|
:openfiles-cur=4096:\
|
|
:openfiles-max=4096:\
|
|
:tc=daemon:
|
|
|
|
Don't forget to rebuild the login.conf.db file (if necessary):
|
|
|
|
# [ -f /etc/login.conf.db ] && cap_mkdb /etc/login.conf
|