pyrox.dev
lol
nixos/doc: explain how to use the ff sync module with ff android (#413380)
+33
-4
+9
nixos/doc/manual/redirects.json
+9
nixos/doc/manual/redirects.json
···
50
50
"module-services-crab-hole-upstream-options": [
51
51
"index.html#module-services-crab-hole-upstream-options"
52
52
],
53
+
"module-services-firefox-syncserver-clients": [
54
+
"index.html#module-services-firefox-syncserver-clients"
55
+
],
56
+
"module-services-firefox-syncserver-clients-android": [
57
+
"index.html#module-services-firefox-syncserver-clients-android"
58
+
],
59
+
"module-services-firefox-syncserver-clients-desktop": [
60
+
"index.html#module-services-firefox-syncserver-clients-desktop"
61
+
],
53
62
"module-services-opencloud": [
54
63
"index.html#module-services-opencloud"
55
64
],
+24
-4
nixos/modules/services/networking/firefox-syncserver.md
+24
-4
nixos/modules/services/networking/firefox-syncserver.md
···
24
24
}
25
25
```
26
26
27
-
This will start a sync server that is only accessible locally. Once the services is
28
-
running you can navigate to `about:config` in your Firefox profile and set
29
-
`identity.sync.tokenserver.uri` to `http://localhost:5000/1.0/sync/1.5`. Your browser
30
-
will now use your local sync server for data storage.
27
+
This will start a sync server that is only accessible locally on the following url: `http://localhost:5000/1.0/sync/1.5`.
28
+
See [the dedicated section](#module-services-firefox-syncserver-clients) to configure your browser to use this sync server.
31
29
32
30
::: {.warning}
33
31
This configuration should never be used in production. It is not encrypted and
···
55
53
56
54
For actual deployment it is also recommended to store the `secrets` file in a
57
55
secure location.
56
+
57
+
## Configuring clients to use this server {#module-services-firefox-syncserver-clients}
58
+
59
+
### Firefox desktop {#module-services-firefox-syncserver-clients-desktop}
60
+
To configure a desktop version of Firefox to use your server, navigate to
61
+
`about:config` in your Firefox profile and set
62
+
`identity.sync.tokenserver.uri` to `https://myhostname:5000/1.0/sync/1.5`.
63
+
64
+
### Firefox Android {#module-services-firefox-syncserver-clients-android}
65
+
To configure an Android version of Firefox to use your server:
66
+
* First ensure that you are disconnected from you Mozilla account.
67
+
* Go to App Menu > Settings > About Firefox and click the logo 5 times. You
68
+
should see a “debug menu enabled” notification.
69
+
* Back to the main menu, a new menu "sync debug" should have appeared.
70
+
* In this menu, set "custom sync server" to `https://myhostname:5000/1.0/sync/1.5`.
71
+
72
+
::: {.warning}
73
+
Changes to this configuration value are ignored if you are currently connected to your account.
74
+
:::
75
+
76
+
* Restart the application.
77
+
* Log in to your account.