Skip to content

Commit

Permalink
autostarting Syncthing Tray
Browse files Browse the repository at this point in the history
  • Loading branch information
taw00 committed Nov 27, 2024
1 parent ba339f3 commit 3f4aacf
Showing 1 changed file with 43 additions and 11 deletions.
54 changes: 43 additions & 11 deletions howto-install-syncthing-on-a-linux-desktop.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,8 @@ flatpak install io.github.martchus.syncthingtray -y

2. **Configure `firewalld` to allow communication with the `syncthing` service**

For more expansive info about firewalld (and fails2ban): <https://github.com/taw00/howto/blob/master/howto-configure-firewalld-and-fail2ban-for-linux.md>
For more expansive info about firewalld (and fails2ban):
<https://github.com/taw00/howto/blob/master/howto-configure-firewalld-and-fail2ban-for-linux.md>

```bash
# Turn on and enable firewalld if not already done...
Expand Down Expand Up @@ -45,15 +46,18 @@ syncthing --user enable syncthing.service
syncthing --user start syncthing.service
```

Configuration and whatnot will, by default, live in `$HOME/.local/state/syncthing/`
Configuration and whatnot will, by default, live in
`$HOME/.local/state/syncthing/`

4. **Browse to <http:127.0.0.1:8384> and configure your instance**

Read the docs! <https://docs.syncthing.net/> Once you have a set username and password and you are happy with your setup …
Read the docs! <https://docs.syncthing.net/> Once you have a set username and
password and you are happy with your setup …

5. **Run the Syncthing Tray application**

In your desktop interface, find the _Syncthing Tray_ application, and run it. Select these options in the wizard that will pop up …
In your desktop interface, find the _Syncthing Tray_ application, and run it.
Select these options in the wizard that will pop up …

- Start guided setup
- Configure Syncthing Tray for currently running Syncthing instance
Expand All @@ -62,13 +66,41 @@ In your desktop interface, find the _Syncthing Tray_ application, and run it. Se
- Copy that ID somewhere (it's also in the webui)
- Finish

Done. You should now see a little Syncthing icon in your system tray if you have that enabled. If you don't see it, you may have to enable the visibility of system tray icons. On GNOME, you do that with the [AppIndicator and KStatusNotifierItem Support](https://extensions.gnome.org/extension/615/appindicator-support/) GNOME Extension. I recommend installing that. Note that you may have to use Firefox to install extensions. I don't know. That is beyond the scope of this document.

If you screw up the Syncthing Tray set up, it is easiest to uninstall it, then start over with the wizard configuration. You will have to uninstall it _and_ close the icon in the system tray (click on the icon and select `Close`).

FYI. The Syncthing Tray application is only useful as an service-wellness barometer. Otherwise it doesn't do much. You can also kick open the webUI with it as well. The color will be green if the `syncthing` service is running okay and it will some other color if something seems to be amiss.

Done! Now follow the docs for using the service: https://docs.syncthing.net/ Set Syncthing up on all of your systems and share files and documents between them.
Done. You should now see a little Syncthing icon in your system tray if you
have that enabled. If you don't see it, you may have to enable the visibility
of system tray icons. On GNOME, you do that with the
[AppIndicator and KStatusNotifierItem Support](https://extensions.gnome.org/extension/615/appindicator-support/)
GNOME Extension. I recommend installing that. Note that you may have to use
Firefox to install extensions. I don't know. That is beyond the scope of this
document.

If you screw up the Syncthing Tray set up, just click the tray icon, choose
`Settings` and click the little wizard wand in the upper right hand corner of
the window to repeat the steps above.

FYI. The Syncthing Tray application is only useful as an service-wellness
barometer. Otherwise it doesn't do much. You can also kick open the webUI with
it as well. The color will be green if the `syncthing` service is running okay
and it will some other color if something seems to be amiss.

6. Configure Syncthing Tray to autostart upon login

Assumption: you are running the GNOME desktop. If not, then, figure it out. :)

Either,
- install the _Gnome Tweaks_ application
- open it
- choose "Startup Applications"
- add _Syncthing Tray_ to the list of applications
Or, assuming you installed Syncthing Tray as a Flatpak application,
- copy Syncthing Tray's `.desktop` file into the `.config/autostart` folder
`cp /var/lib/flatpak/app/io.github.martchus.syncthingtray/current/active/export/share/applications/io.github.martchus.syncthingtray.desktop .config/autostart/`

&nbsp;

Done! Now follow the docs for using the service: https://docs.syncthing.net/
Set Syncthing up on all of your systems and share files and documents between
them.

---

Expand Down

0 comments on commit 3f4aacf

Please sign in to comment.