feat(syncthing): troubleshooting

This commit is contained in:
Michele Cereda
2024-03-03 13:40:32 +01:00
parent f479518f30
commit a5a3c87bb3
2 changed files with 37 additions and 4 deletions

View File

@@ -3,8 +3,11 @@
## Table of contents <!-- omit in toc --> ## Table of contents <!-- omit in toc -->
1. [TL;DR](#tldr) 1. [TL;DR](#tldr)
1. [Configuration](#configuration)
1. [Troubleshooting](#troubleshooting)
1. [I forgot the password](#i-forgot-the-password)
1. [Further readings](#further-readings) 1. [Further readings](#further-readings)
1. [Sources](#sources) 1. [Sources](#sources)
## TL;DR ## TL;DR
@@ -20,22 +23,46 @@ syncthing --gui-address '0.0.0.0:8384' --no-default-folder
systemctl --user start 'syncthing.service' systemctl --user start 'syncthing.service'
``` ```
## Configuration
| OS | Path |
| -------- | -------------------------------------------------------------- |
| Linux | `$XDG_STATE_HOME/syncthing`<br/>`$HOME/.local/state/syncthing` |
| Mac OS X | `$HOME/Library/Application Support/Syncthing` |
| Windows | `%LOCALAPPDATA%\Syncthing` |
## Troubleshooting
### I forgot the password
Remove the entry under `gui.password` in the [configuration file][configuration]:
```sh
# With XMLStarlet
xml ed -L -d 'configuration/gui/password' 'Library/Application Support/Syncthing/config.xml'
```
Then enter the settings on the host and set a new password.
## Further readings ## Further readings
- [Website] - [Website]
## Sources ### Sources
All the references in the [further readings] section, plus the following:
- [The GUI listen address] - [The GUI listen address]
- [File versioning] - [File versioning]
- [Configuration]
<!-- <!--
References References
--> -->
<!-- In-article sections -->
[configuration]: #configuration
<!-- Upstream --> <!-- Upstream -->
[configuration]: https://docs.syncthing.net/users/config.html
[file versioning]: https://docs.syncthing.net/users/versioning.html [file versioning]: https://docs.syncthing.net/users/versioning.html
[the gui listen address]: https://docs.syncthing.net/users/guilisten.html [the gui listen address]: https://docs.syncthing.net/users/guilisten.html
[website]: https://syncthing.net/ [website]: https://syncthing.net/

View File

@@ -0,0 +1,6 @@
https://www.fosslinux.com/114195/ways-to-parse-an-xml-file-on-linux.htm
https://cheat.sh/xmllint
https://cheat.sh/xml
xml sel -t -v configuration/gui/password 'Library/Application Support/Syncthing/config.xml'
xml ed -L -d 'configuration/gui/password' 'Library/Application Support/Syncthing/config.xml'