Add an example of a systemd unit file with a persistent onion

docs/gettext/advanced.pot

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: OnionShare 2.6.2\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-02-09 09:47+1100\n"
+"POT-Creation-Date: 2025-02-09 10:21+1100\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -152,38 +152,94 @@ msgstr ""
 msgid "Browse the command-line documentation by running ``onionshare --help``::"
 msgstr ""
 
-#: ../../source/advanced.rst:171
+#: ../../source/advanced.rst:170
-msgid "Keyboard Shortcuts"
+msgid "Running the CLI as a systemd unit file"
 msgstr ""
 
-#: ../../source/advanced.rst:173
+#: ../../source/advanced.rst:172
-msgid "The OnionShare desktop application contains some keyboard shortcuts, for convenience and accessibility::"
+msgid "It is possible to automatically start OnionShare from the CLI using a systemd unit file."
+msgstr ""
+
+#: ../../source/advanced.rst:174
+msgid "You may find this particularly useful if you are operating in 'persistent' mode, and want to start the same onion service every time your machine starts."
+msgstr ""
+
+#: ../../source/advanced.rst:176
+msgid "To do this, you need to prepare some OnionShare json config first."
 msgstr ""
 
 #: ../../source/advanced.rst:178
+msgid "Here is the main OnionShare config. In this example, it's stored in ``/home/user/.config/onionshare/onionshare.json``. You may need to adjust some of the settings, but if you already have OnionShare installed, it probably looks much like this already::"
+msgstr ""
+
+#: ../../source/advanced.rst:207
+msgid "Notice the 'persistent_tabs' section. We will now create a file at ``/home/user/.config/onionshare/persistent/my-persistent-onion.json``, that looks like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:247
+msgid "**Don't actually use this private key, service_id or client_auth keys! They are shown only as an example. Never share the private_key with anyone.**"
+msgstr ""
+
+#: ../../source/advanced.rst:249
+msgid "The easiest way to generate the onion address and private key is to first create a 'pinned' OnionShare tab in the desktop app and started the share for the first time. This will then have saved the persistent settings to your ``.config/onionshare/persistent/`` folder with a random name. You can unpin that tab once you've generated it the first time. Or, you can leave it where it is, and use that persistent file in your systemd unit file below."
+msgstr ""
+
+#: ../../source/advanced.rst:251
+msgid "Now you can create a systemd unit file in ``/etc/systemd/system/onionshare-cli.service``. Be sure to adjust the User and Group to your own user/group, as well as changes to any paths to the onionshare-cli binary or the paths to your JSON configs and shares."
+msgstr ""
+
+#: ../../source/advanced.rst:253
+msgid "The systemd unit file should look like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:268
+msgid "Note that although ``/home/user/my-shared-file.txt`` was defined in the ``filenames`` section of the ``my-persistent-onion.json`` file, it's still necessary to specify it as the argument to the onionshare-cli command."
+msgstr ""
+
+#: ../../source/advanced.rst:270
+msgid "Be sure to run ``sudo systemctl daemon-reload`` after creating the unit file."
+msgstr ""
+
+#: ../../source/advanced.rst:272
+msgid "Now you can run ``sudo systemctl start onionshare-cli.service``. If you have ``journalctl`` installed, you can run ``sudo journalctl -f -t onionshare-cli``, and you should see some output of your service starting::"
+msgstr ""
+
+#: ../../source/advanced.rst:282
+msgid "If you don't want your users to use a Private Key, set ``public`` to be ``true`` in the ``general`` settings of the my-persistent-onion.json file."
+msgstr ""
+
+#: ../../source/advanced.rst:286
+msgid "Keyboard Shortcuts"
+msgstr ""
+
+#: ../../source/advanced.rst:288
+msgid "The OnionShare desktop application contains some keyboard shortcuts, for convenience and accessibility::"
+msgstr ""
+
+#: ../../source/advanced.rst:293
 msgid "And from the main mode chooser screen::"
 msgstr ""
 
-#: ../../source/advanced.rst:188
+#: ../../source/advanced.rst:303
 msgid "Migrating your OnionShare data to another computer"
 msgstr ""
 
-#: ../../source/advanced.rst:190
+#: ../../source/advanced.rst:305
 msgid "You may want to migrate your OnionShare data when switching to another computer. This is especially true if you had a 'persistent' onion address and you want to preserve it."
 msgstr ""
 
-#: ../../source/advanced.rst:192
+#: ../../source/advanced.rst:307
 msgid "OnionShare stores all such data in a specific folder. Copy the relevant folder for your operating system below, to your new computer:"
 msgstr ""
 
-#: ../../source/advanced.rst:194
+#: ../../source/advanced.rst:309
 msgid "Linux: ``~/.config/onionshare``"
 msgstr ""
 
-#: ../../source/advanced.rst:195
+#: ../../source/advanced.rst:310
 msgid "macOS: ``~/Library/Application Support/OnionShare``"
 msgstr ""
 
-#: ../../source/advanced.rst:196
+#: ../../source/advanced.rst:311
 msgid "Windows: ``%APPDATA%\\OnionShare``"
 msgstr ""

docs/source/advanced.rst

@@ -166,6 +166,121 @@ Browse the command-line documentation by running ``onionshare --help``::
       -v, --verbose             Log OnionShare errors to stdout, and web errors to disk
 
 
+Running the CLI as a systemd unit file
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+It is possible to automatically start OnionShare from the CLI using a systemd unit file.
+
+You may find this particularly useful if you are operating in 'persistent' mode, and want to start the same onion service every time your machine starts.
+
+To do this, you need to prepare some OnionShare json config first.
+
+Here is the main OnionShare config. In this example, it's stored in ``/home/user/.config/onionshare/onionshare.json``. You may need to adjust some of the settings, but if you already have OnionShare installed, it probably looks much like this already::
+
+    {
+      "version": "2.6.2",
+      "connection_type": "bundled",
+      "control_port_address": "127.0.0.1",
+      "control_port_port": 9051,
+      "socks_address": "127.0.0.1",
+      "socks_port": 9050,
+      "socket_file_path": "/var/run/tor/control",
+      "auth_type": "no_auth",
+      "auth_password": "",
+      "auto_connect": true,
+      "use_autoupdate": true,
+      "autoupdate_timestamp": null,
+      "bridges_enabled": false,
+      "bridges_type": "built-in",
+      "bridges_builtin_pt": "obfs4",
+      "bridges_moat": "",
+      "bridges_custom": "",
+      "bridges_builtin": {},
+      "persistent_tabs": [
+          "my-persistent-onion"
+      ],
+      "locale": "en",
+      "theme": 0
+    }
+
+
+Notice the 'persistent_tabs' section. We will now create a file at ``/home/user/.config/onionshare/persistent/my-persistent-onion.json``, that looks like this::
+
+    {
+      "onion": {
+          "private_key": "UDIaZD8QgoXRP8JnAJ+pnlogQazfZ0wrfWJk5zPBGUBqg6+lozzjUJKTYWxwrxR33pDgJdTFtCUN1CX1FE22UQ==",
+          "client_auth_priv_key": "RHJSN4VI3NKGDSIWK45CCWTLYOJHA6DQQRQXUID3FXMAILYXWVUQ",
+          "client_auth_pub_key": "J4YLYAHS25UU3TZTE27H32RN3MCRGLR345U52XS2JNQ76CCHCRSQ"
+      },
+      "persistent": {
+          "mode": "share",
+          "enabled": true
+      },
+      "general": {
+          "title": null,
+          "public": false,
+          "autostart_timer": 0,
+          "autostop_timer": 0,
+          "service_id": "niktadkcp6z7rym3r5o3j2hnmis53mno5ughvur357xo7jkjvmqrchid",
+          "qr": false
+      },
+      "share": {
+         "autostop_sharing": true,
+         "filenames": [
+           "/home/user/my-shared-file.txt"
+         ]
+      },
+      "receive": {
+         "data_dir": "/home/user/OnionShare",
+         "webhook_url": null,
+         "disable_text": false,
+         "disable_files": false
+      },
+      "website": {
+         "disable_csp": false,
+         "custom_csp": null,
+         "filenames": []
+      },
+      "chat": {}
+    }
+
+**Don't actually use this private key, service_id or client_auth keys! They are shown only as an example. Never share the private_key with anyone.**
+
+The easiest way to generate the onion address and private key is to first create a 'pinned' OnionShare tab in the desktop app and started the share for the first time. This will then have saved the persistent settings to your ``.config/onionshare/persistent/`` folder with a random name. You can unpin that tab once you've generated it the first time. Or, you can leave it where it is, and use that persistent file in your systemd unit file below.
+
+Now you can create a systemd unit file in ``/etc/systemd/system/onionshare-cli.service``. Be sure to adjust the User and Group to your own user/group, as well as changes to any paths to the onionshare-cli binary or the paths to your JSON configs and shares.
+
+The systemd unit file should look like this::
+
+    [Unit]
+    Description=OnionShare CLI
+    After=network.target
+
+    [Service]
+    ExecStart=/home/user/.local/bin/onionshare-cli --persistent /home/user/.config/onionshare/persistent/my-persistent-onion.json /home/user/my-shared-file.txt
+    Restart=on-failure
+    User=user
+    Group=user
+
+    [Install]
+    WantedBy=multi-user.target
+
+Note that although ``/home/user/my-shared-file.txt`` was defined in the ``filenames`` section of the ``my-persistent-onion.json`` file, it's still necessary to specify it as the argument to the onionshare-cli command.
+
+Be sure to run ``sudo systemctl daemon-reload`` after creating the unit file.
+
+Now you can run ``sudo systemctl start onionshare-cli.service``. If you have ``journalctl`` installed, you can run ``sudo journalctl -f -t onionshare-cli``, and you should see some output of your service starting::
+
+    [...]
+    Feb 09 10:14:09 onionshare onionshare-cli[18852]: [6.5K blob data]
+    Feb 09 10:14:18 onionshare onionshare-cli[18852]: Compressing files.
+    Feb 09 10:14:18 onionshare onionshare-cli[18852]: Give this address and private key to the recipient:
+    Feb 09 10:14:18 onionshare onionshare-cli[18852]: http://niktadkcp6z7rym3r5o3j2hnmis53mno5ughvur357xo7jkjvmqrchid.onion
+    Feb 09 10:14:18 onionshare onionshare-cli[18852]: Private key: RHJSN4VI3NKGDSIWK45CCWTLYOJHA6DQQRQXUID3FXMAILYXWVUQ
+    Feb 09 10:14:18 onionshare onionshare-cli[18852]: Press Ctrl+C to stop the server
+
+If you don't want your users to use a Private Key, set ``public`` to be ``true`` in the ``general`` settings of the my-persistent-onion.json file.
+
 
 Keyboard Shortcuts
 ------------------

docs/source/locale/de/LC_MESSAGES/advanced.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: OnionShare 2.3\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-02-09 09:47+1100\n"
+"POT-Creation-Date: 2025-02-09 10:21+1100\n"
 "PO-Revision-Date: 2023-12-25 11:10+0000\n"
 "Last-Translator: curtisb <curtisbaltimore@protonmail.com>\n"
 "Language: de\n"
@@ -283,11 +283,106 @@ msgstr ""
 "Die Dokumentation zur Kommandozeile kann über den Befehl ``onionshare "
 "--help`` abgerufen werden::"
 
-#: ../../source/advanced.rst:171
+#: ../../source/advanced.rst:170
+msgid "Running the CLI as a systemd unit file"
+msgstr ""
+
+#: ../../source/advanced.rst:172
+msgid ""
+"It is possible to automatically start OnionShare from the CLI using a "
+"systemd unit file."
+msgstr ""
+
+#: ../../source/advanced.rst:174
+msgid ""
+"You may find this particularly useful if you are operating in "
+"'persistent' mode, and want to start the same onion service every time "
+"your machine starts."
+msgstr ""
+
+#: ../../source/advanced.rst:176
+msgid "To do this, you need to prepare some OnionShare json config first."
+msgstr ""
+
+#: ../../source/advanced.rst:178
+msgid ""
+"Here is the main OnionShare config. In this example, it's stored in "
+"``/home/user/.config/onionshare/onionshare.json``. You may need to adjust"
+" some of the settings, but if you already have OnionShare installed, it "
+"probably looks much like this already::"
+msgstr ""
+
+#: ../../source/advanced.rst:207
+msgid ""
+"Notice the 'persistent_tabs' section. We will now create a file at "
+"``/home/user/.config/onionshare/persistent/my-persistent-onion.json``, "
+"that looks like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:247
+msgid ""
+"**Don't actually use this private key, service_id or client_auth keys! "
+"They are shown only as an example. Never share the private_key with "
+"anyone.**"
+msgstr ""
+
+#: ../../source/advanced.rst:249
+msgid ""
+"The easiest way to generate the onion address and private key is to first"
+" create a 'pinned' OnionShare tab in the desktop app and started the "
+"share for the first time. This will then have saved the persistent "
+"settings to your ``.config/onionshare/persistent/`` folder with a random "
+"name. You can unpin that tab once you've generated it the first time. Or,"
+" you can leave it where it is, and use that persistent file in your "
+"systemd unit file below."
+msgstr ""
+
+#: ../../source/advanced.rst:251
+msgid ""
+"Now you can create a systemd unit file in ``/etc/systemd/system"
+"/onionshare-cli.service``. Be sure to adjust the User and Group to your "
+"own user/group, as well as changes to any paths to the onionshare-cli "
+"binary or the paths to your JSON configs and shares."
+msgstr ""
+
+#: ../../source/advanced.rst:253
+msgid "The systemd unit file should look like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:268
+msgid ""
+"Note that although ``/home/user/my-shared-file.txt`` was defined in the "
+"``filenames`` section of the ``my-persistent-onion.json`` file, it's "
+"still necessary to specify it as the argument to the onionshare-cli "
+"command."
+msgstr ""
+
+#: ../../source/advanced.rst:270
+msgid ""
+"Be sure to run ``sudo systemctl daemon-reload`` after creating the unit "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:272
+msgid ""
+"Now you can run ``sudo systemctl start onionshare-cli.service``. If you "
+"have ``journalctl`` installed, you can run ``sudo journalctl -f -t "
+"onionshare-cli``, and you should see some output of your service "
+"starting::"
+msgstr ""
+
+#: ../../source/advanced.rst:282
+msgid ""
+"If you don't want your users to use a Private Key, set ``public`` to be "
+"``true`` in the ``general`` settings of the my-persistent-onion.json "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:286
 msgid "Keyboard Shortcuts"
 msgstr "Tastaturkurzbefehle"
 
-#: ../../source/advanced.rst:173
+#: ../../source/advanced.rst:288
 msgid ""
 "The OnionShare desktop application contains some keyboard shortcuts, for "
 "convenience and accessibility::"
@@ -295,36 +390,36 @@ msgstr ""
 "Die OnionShare-Desktop-Anwendung enthält einige Tastaturkurzbefehle, die "
 "der Bequemlichkeit und Zugänglichkeit dienen::"
 
-#: ../../source/advanced.rst:178
+#: ../../source/advanced.rst:293
 msgid "And from the main mode chooser screen::"
 msgstr "Und auf dem Hauptbildschirm für die Modusauswahl::"
 
-#: ../../source/advanced.rst:188
+#: ../../source/advanced.rst:303
 msgid "Migrating your OnionShare data to another computer"
 msgstr ""
 
-#: ../../source/advanced.rst:190
+#: ../../source/advanced.rst:305
 msgid ""
 "You may want to migrate your OnionShare data when switching to another "
 "computer. This is especially true if you had a 'persistent' onion address"
 " and you want to preserve it."
 msgstr ""
 
-#: ../../source/advanced.rst:192
+#: ../../source/advanced.rst:307
 msgid ""
 "OnionShare stores all such data in a specific folder. Copy the relevant "
 "folder for your operating system below, to your new computer:"
 msgstr ""
 
-#: ../../source/advanced.rst:194
+#: ../../source/advanced.rst:309
 msgid "Linux: ``~/.config/onionshare``"
 msgstr ""
 
-#: ../../source/advanced.rst:195
+#: ../../source/advanced.rst:310
 msgid "macOS: ``~/Library/Application Support/OnionShare``"
 msgstr ""
 
-#: ../../source/advanced.rst:196
+#: ../../source/advanced.rst:311
 msgid "Windows: ``%APPDATA%\\OnionShare``"
 msgstr ""
 
@@ -690,3 +785,11 @@ msgstr ""
 #~ "``%APPDATA%\\OnionShare``"
 #~ msgstr ""
 
+#~ msgid ""
+#~ "__Don't actually use this private key,"
+#~ " service_id or client_auth keys! They "
+#~ "are shown only as an example. "
+#~ "Never share the private_key with "
+#~ "anyone.__"
+#~ msgstr ""
+

docs/source/locale/el/LC_MESSAGES/advanced.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: OnionShare 2.3\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-02-09 09:47+1100\n"
+"POT-Creation-Date: 2025-02-09 10:21+1100\n"
 "PO-Revision-Date: 2023-10-28 04:15+0000\n"
 "Last-Translator: george kitsoukakis <norhorn@gmail.com>\n"
 "Language: el\n"
@@ -278,11 +278,106 @@ msgstr ""
 "Περιηγηθείτε στην τεκμηρίωση της γραμμής εντολών με ``onionshare "
 "--help``::"
 
-#: ../../source/advanced.rst:171
+#: ../../source/advanced.rst:170
+msgid "Running the CLI as a systemd unit file"
+msgstr ""
+
+#: ../../source/advanced.rst:172
+msgid ""
+"It is possible to automatically start OnionShare from the CLI using a "
+"systemd unit file."
+msgstr ""
+
+#: ../../source/advanced.rst:174
+msgid ""
+"You may find this particularly useful if you are operating in "
+"'persistent' mode, and want to start the same onion service every time "
+"your machine starts."
+msgstr ""
+
+#: ../../source/advanced.rst:176
+msgid "To do this, you need to prepare some OnionShare json config first."
+msgstr ""
+
+#: ../../source/advanced.rst:178
+msgid ""
+"Here is the main OnionShare config. In this example, it's stored in "
+"``/home/user/.config/onionshare/onionshare.json``. You may need to adjust"
+" some of the settings, but if you already have OnionShare installed, it "
+"probably looks much like this already::"
+msgstr ""
+
+#: ../../source/advanced.rst:207
+msgid ""
+"Notice the 'persistent_tabs' section. We will now create a file at "
+"``/home/user/.config/onionshare/persistent/my-persistent-onion.json``, "
+"that looks like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:247
+msgid ""
+"**Don't actually use this private key, service_id or client_auth keys! "
+"They are shown only as an example. Never share the private_key with "
+"anyone.**"
+msgstr ""
+
+#: ../../source/advanced.rst:249
+msgid ""
+"The easiest way to generate the onion address and private key is to first"
+" create a 'pinned' OnionShare tab in the desktop app and started the "
+"share for the first time. This will then have saved the persistent "
+"settings to your ``.config/onionshare/persistent/`` folder with a random "
+"name. You can unpin that tab once you've generated it the first time. Or,"
+" you can leave it where it is, and use that persistent file in your "
+"systemd unit file below."
+msgstr ""
+
+#: ../../source/advanced.rst:251
+msgid ""
+"Now you can create a systemd unit file in ``/etc/systemd/system"
+"/onionshare-cli.service``. Be sure to adjust the User and Group to your "
+"own user/group, as well as changes to any paths to the onionshare-cli "
+"binary or the paths to your JSON configs and shares."
+msgstr ""
+
+#: ../../source/advanced.rst:253
+msgid "The systemd unit file should look like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:268
+msgid ""
+"Note that although ``/home/user/my-shared-file.txt`` was defined in the "
+"``filenames`` section of the ``my-persistent-onion.json`` file, it's "
+"still necessary to specify it as the argument to the onionshare-cli "
+"command."
+msgstr ""
+
+#: ../../source/advanced.rst:270
+msgid ""
+"Be sure to run ``sudo systemctl daemon-reload`` after creating the unit "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:272
+msgid ""
+"Now you can run ``sudo systemctl start onionshare-cli.service``. If you "
+"have ``journalctl`` installed, you can run ``sudo journalctl -f -t "
+"onionshare-cli``, and you should see some output of your service "
+"starting::"
+msgstr ""
+
+#: ../../source/advanced.rst:282
+msgid ""
+"If you don't want your users to use a Private Key, set ``public`` to be "
+"``true`` in the ``general`` settings of the my-persistent-onion.json "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:286
 msgid "Keyboard Shortcuts"
 msgstr "Συντομεύσεις πληκτρολογίου"
 
-#: ../../source/advanced.rst:173
+#: ../../source/advanced.rst:288
 msgid ""
 "The OnionShare desktop application contains some keyboard shortcuts, for "
 "convenience and accessibility::"
@@ -290,36 +385,36 @@ msgstr ""
 "Η εφαρμογή για υπολογιστή του OnionShare περιέχει ορισμένες συντομεύσεις "
 "πληκτρολογίου, για αμεσότητα και εύκολη πρόσβαση::"
 
-#: ../../source/advanced.rst:178
+#: ../../source/advanced.rst:293
 msgid "And from the main mode chooser screen::"
 msgstr "Και από την κύρια οθόνη επιλογής λειτουργίας::"
 
-#: ../../source/advanced.rst:188
+#: ../../source/advanced.rst:303
 msgid "Migrating your OnionShare data to another computer"
 msgstr ""
 
-#: ../../source/advanced.rst:190
+#: ../../source/advanced.rst:305
 msgid ""
 "You may want to migrate your OnionShare data when switching to another "
 "computer. This is especially true if you had a 'persistent' onion address"
 " and you want to preserve it."
 msgstr ""
 
-#: ../../source/advanced.rst:192
+#: ../../source/advanced.rst:307
 msgid ""
 "OnionShare stores all such data in a specific folder. Copy the relevant "
 "folder for your operating system below, to your new computer:"
 msgstr ""
 
-#: ../../source/advanced.rst:194
+#: ../../source/advanced.rst:309
 msgid "Linux: ``~/.config/onionshare``"
 msgstr ""
 
-#: ../../source/advanced.rst:195
+#: ../../source/advanced.rst:310
 msgid "macOS: ``~/Library/Application Support/OnionShare``"
 msgstr ""
 
-#: ../../source/advanced.rst:196
+#: ../../source/advanced.rst:311
 msgid "Windows: ``%APPDATA%\\OnionShare``"
 msgstr ""
 
@@ -593,3 +688,11 @@ msgstr ""
 #~ "``%APPDATA%\\OnionShare``"
 #~ msgstr ""
 
+#~ msgid ""
+#~ "__Don't actually use this private key,"
+#~ " service_id or client_auth keys! They "
+#~ "are shown only as an example. "
+#~ "Never share the private_key with "
+#~ "anyone.__"
+#~ msgstr ""
+

docs/source/locale/en/LC_MESSAGES/advanced.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: OnionShare 2.3\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-02-09 09:47+1100\n"
+"POT-Creation-Date: 2025-02-09 10:21+1100\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -211,46 +211,141 @@ msgstr ""
 msgid "Browse the command-line documentation by running ``onionshare --help``::"
 msgstr ""
 
-#: ../../source/advanced.rst:171
+#: ../../source/advanced.rst:170
+msgid "Running the CLI as a systemd unit file"
+msgstr ""
+
+#: ../../source/advanced.rst:172
+msgid ""
+"It is possible to automatically start OnionShare from the CLI using a "
+"systemd unit file."
+msgstr ""
+
+#: ../../source/advanced.rst:174
+msgid ""
+"You may find this particularly useful if you are operating in "
+"'persistent' mode, and want to start the same onion service every time "
+"your machine starts."
+msgstr ""
+
+#: ../../source/advanced.rst:176
+msgid "To do this, you need to prepare some OnionShare json config first."
+msgstr ""
+
+#: ../../source/advanced.rst:178
+msgid ""
+"Here is the main OnionShare config. In this example, it's stored in "
+"``/home/user/.config/onionshare/onionshare.json``. You may need to adjust"
+" some of the settings, but if you already have OnionShare installed, it "
+"probably looks much like this already::"
+msgstr ""
+
+#: ../../source/advanced.rst:207
+msgid ""
+"Notice the 'persistent_tabs' section. We will now create a file at "
+"``/home/user/.config/onionshare/persistent/my-persistent-onion.json``, "
+"that looks like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:247
+msgid ""
+"**Don't actually use this private key, service_id or client_auth keys! "
+"They are shown only as an example. Never share the private_key with "
+"anyone.**"
+msgstr ""
+
+#: ../../source/advanced.rst:249
+msgid ""
+"The easiest way to generate the onion address and private key is to first"
+" create a 'pinned' OnionShare tab in the desktop app and started the "
+"share for the first time. This will then have saved the persistent "
+"settings to your ``.config/onionshare/persistent/`` folder with a random "
+"name. You can unpin that tab once you've generated it the first time. Or,"
+" you can leave it where it is, and use that persistent file in your "
+"systemd unit file below."
+msgstr ""
+
+#: ../../source/advanced.rst:251
+msgid ""
+"Now you can create a systemd unit file in ``/etc/systemd/system"
+"/onionshare-cli.service``. Be sure to adjust the User and Group to your "
+"own user/group, as well as changes to any paths to the onionshare-cli "
+"binary or the paths to your JSON configs and shares."
+msgstr ""
+
+#: ../../source/advanced.rst:253
+msgid "The systemd unit file should look like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:268
+msgid ""
+"Note that although ``/home/user/my-shared-file.txt`` was defined in the "
+"``filenames`` section of the ``my-persistent-onion.json`` file, it's "
+"still necessary to specify it as the argument to the onionshare-cli "
+"command."
+msgstr ""
+
+#: ../../source/advanced.rst:270
+msgid ""
+"Be sure to run ``sudo systemctl daemon-reload`` after creating the unit "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:272
+msgid ""
+"Now you can run ``sudo systemctl start onionshare-cli.service``. If you "
+"have ``journalctl`` installed, you can run ``sudo journalctl -f -t "
+"onionshare-cli``, and you should see some output of your service "
+"starting::"
+msgstr ""
+
+#: ../../source/advanced.rst:282
+msgid ""
+"If you don't want your users to use a Private Key, set ``public`` to be "
+"``true`` in the ``general`` settings of the my-persistent-onion.json "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:286
 msgid "Keyboard Shortcuts"
 msgstr ""
 
-#: ../../source/advanced.rst:173
+#: ../../source/advanced.rst:288
 msgid ""
 "The OnionShare desktop application contains some keyboard shortcuts, for "
 "convenience and accessibility::"
 msgstr ""
 
-#: ../../source/advanced.rst:178
+#: ../../source/advanced.rst:293
 msgid "And from the main mode chooser screen::"
 msgstr ""
 
-#: ../../source/advanced.rst:188
+#: ../../source/advanced.rst:303
 msgid "Migrating your OnionShare data to another computer"
 msgstr ""
 
-#: ../../source/advanced.rst:190
+#: ../../source/advanced.rst:305
 msgid ""
 "You may want to migrate your OnionShare data when switching to another "
 "computer. This is especially true if you had a 'persistent' onion address"
 " and you want to preserve it."
 msgstr ""
 
-#: ../../source/advanced.rst:192
+#: ../../source/advanced.rst:307
 msgid ""
 "OnionShare stores all such data in a specific folder. Copy the relevant "
 "folder for your operating system below, to your new computer:"
 msgstr ""
 
-#: ../../source/advanced.rst:194
+#: ../../source/advanced.rst:309
 msgid "Linux: ``~/.config/onionshare``"
 msgstr ""
 
-#: ../../source/advanced.rst:195
+#: ../../source/advanced.rst:310
 msgid "macOS: ``~/Library/Application Support/OnionShare``"
 msgstr ""
 
-#: ../../source/advanced.rst:196
+#: ../../source/advanced.rst:311
 msgid "Windows: ``%APPDATA%\\OnionShare``"
 msgstr ""
 
@@ -282,3 +377,11 @@ msgstr ""
 #~ "``%APPDATA%\\OnionShare``"
 #~ msgstr ""
 
+#~ msgid ""
+#~ "__Don't actually use this private key,"
+#~ " service_id or client_auth keys! They "
+#~ "are shown only as an example. "
+#~ "Never share the private_key with "
+#~ "anyone.__"
+#~ msgstr ""
+

docs/source/locale/es/LC_MESSAGES/advanced.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: OnionShare 2.3\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-02-09 09:47+1100\n"
+"POT-Creation-Date: 2025-02-09 10:21+1100\n"
 "PO-Revision-Date: 2023-06-02 11:21+0000\n"
 "Last-Translator: emma peel <emmapeel@torproject.org>\n"
 "Language: es\n"
@@ -273,11 +273,106 @@ msgstr ""
 "Navega por la documentación de línea de comando ejecutando ``onionshare "
 "--help``::"
 
-#: ../../source/advanced.rst:171
+#: ../../source/advanced.rst:170
+msgid "Running the CLI as a systemd unit file"
+msgstr ""
+
+#: ../../source/advanced.rst:172
+msgid ""
+"It is possible to automatically start OnionShare from the CLI using a "
+"systemd unit file."
+msgstr ""
+
+#: ../../source/advanced.rst:174
+msgid ""
+"You may find this particularly useful if you are operating in "
+"'persistent' mode, and want to start the same onion service every time "
+"your machine starts."
+msgstr ""
+
+#: ../../source/advanced.rst:176
+msgid "To do this, you need to prepare some OnionShare json config first."
+msgstr ""
+
+#: ../../source/advanced.rst:178
+msgid ""
+"Here is the main OnionShare config. In this example, it's stored in "
+"``/home/user/.config/onionshare/onionshare.json``. You may need to adjust"
+" some of the settings, but if you already have OnionShare installed, it "
+"probably looks much like this already::"
+msgstr ""
+
+#: ../../source/advanced.rst:207
+msgid ""
+"Notice the 'persistent_tabs' section. We will now create a file at "
+"``/home/user/.config/onionshare/persistent/my-persistent-onion.json``, "
+"that looks like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:247
+msgid ""
+"**Don't actually use this private key, service_id or client_auth keys! "
+"They are shown only as an example. Never share the private_key with "
+"anyone.**"
+msgstr ""
+
+#: ../../source/advanced.rst:249
+msgid ""
+"The easiest way to generate the onion address and private key is to first"
+" create a 'pinned' OnionShare tab in the desktop app and started the "
+"share for the first time. This will then have saved the persistent "
+"settings to your ``.config/onionshare/persistent/`` folder with a random "
+"name. You can unpin that tab once you've generated it the first time. Or,"
+" you can leave it where it is, and use that persistent file in your "
+"systemd unit file below."
+msgstr ""
+
+#: ../../source/advanced.rst:251
+msgid ""
+"Now you can create a systemd unit file in ``/etc/systemd/system"
+"/onionshare-cli.service``. Be sure to adjust the User and Group to your "
+"own user/group, as well as changes to any paths to the onionshare-cli "
+"binary or the paths to your JSON configs and shares."
+msgstr ""
+
+#: ../../source/advanced.rst:253
+msgid "The systemd unit file should look like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:268
+msgid ""
+"Note that although ``/home/user/my-shared-file.txt`` was defined in the "
+"``filenames`` section of the ``my-persistent-onion.json`` file, it's "
+"still necessary to specify it as the argument to the onionshare-cli "
+"command."
+msgstr ""
+
+#: ../../source/advanced.rst:270
+msgid ""
+"Be sure to run ``sudo systemctl daemon-reload`` after creating the unit "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:272
+msgid ""
+"Now you can run ``sudo systemctl start onionshare-cli.service``. If you "
+"have ``journalctl`` installed, you can run ``sudo journalctl -f -t "
+"onionshare-cli``, and you should see some output of your service "
+"starting::"
+msgstr ""
+
+#: ../../source/advanced.rst:282
+msgid ""
+"If you don't want your users to use a Private Key, set ``public`` to be "
+"``true`` in the ``general`` settings of the my-persistent-onion.json "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:286
 msgid "Keyboard Shortcuts"
 msgstr "Atajos de teclado"
 
-#: ../../source/advanced.rst:173
+#: ../../source/advanced.rst:288
 msgid ""
 "The OnionShare desktop application contains some keyboard shortcuts, for "
 "convenience and accessibility::"
@@ -285,36 +380,36 @@ msgstr ""
 "La aplicación de escritorio OnionShare contiene algunos atajos de "
 "teclado, para mayor comodidad y accesibilidad::"
 
-#: ../../source/advanced.rst:178
+#: ../../source/advanced.rst:293
 msgid "And from the main mode chooser screen::"
 msgstr "Y desde la pantalla principal del selector de modo::"
 
-#: ../../source/advanced.rst:188
+#: ../../source/advanced.rst:303
 msgid "Migrating your OnionShare data to another computer"
 msgstr ""
 
-#: ../../source/advanced.rst:190
+#: ../../source/advanced.rst:305
 msgid ""
 "You may want to migrate your OnionShare data when switching to another "
 "computer. This is especially true if you had a 'persistent' onion address"
 " and you want to preserve it."
 msgstr ""
 
-#: ../../source/advanced.rst:192
+#: ../../source/advanced.rst:307
 msgid ""
 "OnionShare stores all such data in a specific folder. Copy the relevant "
 "folder for your operating system below, to your new computer:"
 msgstr ""
 
-#: ../../source/advanced.rst:194
+#: ../../source/advanced.rst:309
 msgid "Linux: ``~/.config/onionshare``"
 msgstr ""
 
-#: ../../source/advanced.rst:195
+#: ../../source/advanced.rst:310
 msgid "macOS: ``~/Library/Application Support/OnionShare``"
 msgstr ""
 
-#: ../../source/advanced.rst:196
+#: ../../source/advanced.rst:311
 msgid "Windows: ``%APPDATA%\\OnionShare``"
 msgstr ""
 
@@ -710,3 +805,11 @@ msgstr ""
 #~ "``%APPDATA%\\OnionShare``"
 #~ msgstr ""
 
+#~ msgid ""
+#~ "__Don't actually use this private key,"
+#~ " service_id or client_auth keys! They "
+#~ "are shown only as an example. "
+#~ "Never share the private_key with "
+#~ "anyone.__"
+#~ msgstr ""
+

docs/source/locale/fr/LC_MESSAGES/advanced.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: OnionShare 2.3\n"
 "Report-Msgid-Bugs-To: onionshare-dev@lists.riseup.net\n"
-"POT-Creation-Date: 2025-02-09 09:47+1100\n"
+"POT-Creation-Date: 2025-02-09 10:21+1100\n"
 "PO-Revision-Date: 2024-04-03 16:01+0000\n"
 "Last-Translator: AO Localisation Lab <ao@localizationlab.org>\n"
 "Language: fr\n"
@@ -277,11 +277,106 @@ msgstr ""
 "Vous pouvez consulter la documentation de l'interface en ligne de "
 "commande en lançant ``onionshare --help`` : :"
 
-#: ../../source/advanced.rst:171
+#: ../../source/advanced.rst:170
+msgid "Running the CLI as a systemd unit file"
+msgstr ""
+
+#: ../../source/advanced.rst:172
+msgid ""
+"It is possible to automatically start OnionShare from the CLI using a "
+"systemd unit file."
+msgstr ""
+
+#: ../../source/advanced.rst:174
+msgid ""
+"You may find this particularly useful if you are operating in "
+"'persistent' mode, and want to start the same onion service every time "
+"your machine starts."
+msgstr ""
+
+#: ../../source/advanced.rst:176
+msgid "To do this, you need to prepare some OnionShare json config first."
+msgstr ""
+
+#: ../../source/advanced.rst:178
+msgid ""
+"Here is the main OnionShare config. In this example, it's stored in "
+"``/home/user/.config/onionshare/onionshare.json``. You may need to adjust"
+" some of the settings, but if you already have OnionShare installed, it "
+"probably looks much like this already::"
+msgstr ""
+
+#: ../../source/advanced.rst:207
+msgid ""
+"Notice the 'persistent_tabs' section. We will now create a file at "
+"``/home/user/.config/onionshare/persistent/my-persistent-onion.json``, "
+"that looks like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:247
+msgid ""
+"**Don't actually use this private key, service_id or client_auth keys! "
+"They are shown only as an example. Never share the private_key with "
+"anyone.**"
+msgstr ""
+
+#: ../../source/advanced.rst:249
+msgid ""
+"The easiest way to generate the onion address and private key is to first"
+" create a 'pinned' OnionShare tab in the desktop app and started the "
+"share for the first time. This will then have saved the persistent "
+"settings to your ``.config/onionshare/persistent/`` folder with a random "
+"name. You can unpin that tab once you've generated it the first time. Or,"
+" you can leave it where it is, and use that persistent file in your "
+"systemd unit file below."
+msgstr ""
+
+#: ../../source/advanced.rst:251
+msgid ""
+"Now you can create a systemd unit file in ``/etc/systemd/system"
+"/onionshare-cli.service``. Be sure to adjust the User and Group to your "
+"own user/group, as well as changes to any paths to the onionshare-cli "
+"binary or the paths to your JSON configs and shares."
+msgstr ""
+
+#: ../../source/advanced.rst:253
+msgid "The systemd unit file should look like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:268
+msgid ""
+"Note that although ``/home/user/my-shared-file.txt`` was defined in the "
+"``filenames`` section of the ``my-persistent-onion.json`` file, it's "
+"still necessary to specify it as the argument to the onionshare-cli "
+"command."
+msgstr ""
+
+#: ../../source/advanced.rst:270
+msgid ""
+"Be sure to run ``sudo systemctl daemon-reload`` after creating the unit "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:272
+msgid ""
+"Now you can run ``sudo systemctl start onionshare-cli.service``. If you "
+"have ``journalctl`` installed, you can run ``sudo journalctl -f -t "
+"onionshare-cli``, and you should see some output of your service "
+"starting::"
+msgstr ""
+
+#: ../../source/advanced.rst:282
+msgid ""
+"If you don't want your users to use a Private Key, set ``public`` to be "
+"``true`` in the ``general`` settings of the my-persistent-onion.json "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:286
 msgid "Keyboard Shortcuts"
 msgstr "Raccourcis Clavier"
 
-#: ../../source/advanced.rst:173
+#: ../../source/advanced.rst:288
 msgid ""
 "The OnionShare desktop application contains some keyboard shortcuts, for "
 "convenience and accessibility::"
@@ -289,36 +384,36 @@ msgstr ""
 "L'application de bureau OnionShare contient quelques raccourcis clavier, "
 "pour des raisons de commodité et d'accessibilité : :"
 
-#: ../../source/advanced.rst:178
+#: ../../source/advanced.rst:293
 msgid "And from the main mode chooser screen::"
 msgstr "Et à partir de l'écran principal du sélecteur de mode :"
 
-#: ../../source/advanced.rst:188
+#: ../../source/advanced.rst:303
 msgid "Migrating your OnionShare data to another computer"
 msgstr ""
 
-#: ../../source/advanced.rst:190
+#: ../../source/advanced.rst:305
 msgid ""
 "You may want to migrate your OnionShare data when switching to another "
 "computer. This is especially true if you had a 'persistent' onion address"
 " and you want to preserve it."
 msgstr ""
 
-#: ../../source/advanced.rst:192
+#: ../../source/advanced.rst:307
 msgid ""
 "OnionShare stores all such data in a specific folder. Copy the relevant "
 "folder for your operating system below, to your new computer:"
 msgstr ""
 
-#: ../../source/advanced.rst:194
+#: ../../source/advanced.rst:309
 msgid "Linux: ``~/.config/onionshare``"
 msgstr ""
 
-#: ../../source/advanced.rst:195
+#: ../../source/advanced.rst:310
 msgid "macOS: ``~/Library/Application Support/OnionShare``"
 msgstr ""
 
-#: ../../source/advanced.rst:196
+#: ../../source/advanced.rst:311
 msgid "Windows: ``%APPDATA%\\OnionShare``"
 msgstr ""
 
@@ -409,3 +504,11 @@ msgstr ""
 #~ "``%APPDATA%\\OnionShare``"
 #~ msgstr ""
 
+#~ msgid ""
+#~ "__Don't actually use this private key,"
+#~ " service_id or client_auth keys! They "
+#~ "are shown only as an example. "
+#~ "Never share the private_key with "
+#~ "anyone.__"
+#~ msgstr ""
+

docs/source/locale/ja/LC_MESSAGES/advanced.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: OnionShare 2.3\n"
 "Report-Msgid-Bugs-To: onionshare-dev@lists.riseup.net\n"
-"POT-Creation-Date: 2025-02-09 09:47+1100\n"
+"POT-Creation-Date: 2025-02-09 10:21+1100\n"
 "PO-Revision-Date: 2024-09-23 09:55+0000\n"
 "Last-Translator: Himmel <Himmel@users.noreply.hosted.weblate.org>\n"
 "Language: ja\n"
@@ -230,46 +230,141 @@ msgstr "使い方"
 msgid "Browse the command-line documentation by running ``onionshare --help``::"
 msgstr "コマンドラインのドキュメンテーションは ``onionshare --help`` で閲覧できます。"
 
-#: ../../source/advanced.rst:171
+#: ../../source/advanced.rst:170
+msgid "Running the CLI as a systemd unit file"
+msgstr ""
+
+#: ../../source/advanced.rst:172
+msgid ""
+"It is possible to automatically start OnionShare from the CLI using a "
+"systemd unit file."
+msgstr ""
+
+#: ../../source/advanced.rst:174
+msgid ""
+"You may find this particularly useful if you are operating in "
+"'persistent' mode, and want to start the same onion service every time "
+"your machine starts."
+msgstr ""
+
+#: ../../source/advanced.rst:176
+msgid "To do this, you need to prepare some OnionShare json config first."
+msgstr ""
+
+#: ../../source/advanced.rst:178
+msgid ""
+"Here is the main OnionShare config. In this example, it's stored in "
+"``/home/user/.config/onionshare/onionshare.json``. You may need to adjust"
+" some of the settings, but if you already have OnionShare installed, it "
+"probably looks much like this already::"
+msgstr ""
+
+#: ../../source/advanced.rst:207
+msgid ""
+"Notice the 'persistent_tabs' section. We will now create a file at "
+"``/home/user/.config/onionshare/persistent/my-persistent-onion.json``, "
+"that looks like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:247
+msgid ""
+"**Don't actually use this private key, service_id or client_auth keys! "
+"They are shown only as an example. Never share the private_key with "
+"anyone.**"
+msgstr ""
+
+#: ../../source/advanced.rst:249
+msgid ""
+"The easiest way to generate the onion address and private key is to first"
+" create a 'pinned' OnionShare tab in the desktop app and started the "
+"share for the first time. This will then have saved the persistent "
+"settings to your ``.config/onionshare/persistent/`` folder with a random "
+"name. You can unpin that tab once you've generated it the first time. Or,"
+" you can leave it where it is, and use that persistent file in your "
+"systemd unit file below."
+msgstr ""
+
+#: ../../source/advanced.rst:251
+msgid ""
+"Now you can create a systemd unit file in ``/etc/systemd/system"
+"/onionshare-cli.service``. Be sure to adjust the User and Group to your "
+"own user/group, as well as changes to any paths to the onionshare-cli "
+"binary or the paths to your JSON configs and shares."
+msgstr ""
+
+#: ../../source/advanced.rst:253
+msgid "The systemd unit file should look like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:268
+msgid ""
+"Note that although ``/home/user/my-shared-file.txt`` was defined in the "
+"``filenames`` section of the ``my-persistent-onion.json`` file, it's "
+"still necessary to specify it as the argument to the onionshare-cli "
+"command."
+msgstr ""
+
+#: ../../source/advanced.rst:270
+msgid ""
+"Be sure to run ``sudo systemctl daemon-reload`` after creating the unit "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:272
+msgid ""
+"Now you can run ``sudo systemctl start onionshare-cli.service``. If you "
+"have ``journalctl`` installed, you can run ``sudo journalctl -f -t "
+"onionshare-cli``, and you should see some output of your service "
+"starting::"
+msgstr ""
+
+#: ../../source/advanced.rst:282
+msgid ""
+"If you don't want your users to use a Private Key, set ``public`` to be "
+"``true`` in the ``general`` settings of the my-persistent-onion.json "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:286
 msgid "Keyboard Shortcuts"
 msgstr "キーボードのショートカット"
 
-#: ../../source/advanced.rst:173
+#: ../../source/advanced.rst:288
 msgid ""
 "The OnionShare desktop application contains some keyboard shortcuts, for "
 "convenience and accessibility::"
 msgstr "OnionShareのデスクトップアプリケーションには、利便性とアクセシビリティーの観点から、いくつかのキーボードショートカットがあります。"
 
-#: ../../source/advanced.rst:178
+#: ../../source/advanced.rst:293
 msgid "And from the main mode chooser screen::"
 msgstr "メインモードの選択画面については、以下のショートカットがあります。"
 
-#: ../../source/advanced.rst:188
+#: ../../source/advanced.rst:303
 msgid "Migrating your OnionShare data to another computer"
 msgstr ""
 
-#: ../../source/advanced.rst:190
+#: ../../source/advanced.rst:305
 msgid ""
 "You may want to migrate your OnionShare data when switching to another "
 "computer. This is especially true if you had a 'persistent' onion address"
 " and you want to preserve it."
 msgstr ""
 
-#: ../../source/advanced.rst:192
+#: ../../source/advanced.rst:307
 msgid ""
 "OnionShare stores all such data in a specific folder. Copy the relevant "
 "folder for your operating system below, to your new computer:"
 msgstr ""
 
-#: ../../source/advanced.rst:194
+#: ../../source/advanced.rst:309
 msgid "Linux: ``~/.config/onionshare``"
 msgstr ""
 
-#: ../../source/advanced.rst:195
+#: ../../source/advanced.rst:310
 msgid "macOS: ``~/Library/Application Support/OnionShare``"
 msgstr ""
 
-#: ../../source/advanced.rst:196
+#: ../../source/advanced.rst:311
 msgid "Windows: ``%APPDATA%\\OnionShare``"
 msgstr ""
 
@@ -331,3 +426,11 @@ msgstr ""
 #~ "``%APPDATA%\\OnionShare``"
 #~ msgstr ""
 
+#~ msgid ""
+#~ "__Don't actually use this private key,"
+#~ " service_id or client_auth keys! They "
+#~ "are shown only as an example. "
+#~ "Never share the private_key with "
+#~ "anyone.__"
+#~ msgstr ""
+

docs/source/locale/pl/LC_MESSAGES/advanced.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: OnionShare 2.3\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-02-09 09:47+1100\n"
+"POT-Creation-Date: 2025-02-09 10:21+1100\n"
 "PO-Revision-Date: 2022-12-12 06:49+0000\n"
 "Last-Translator: Matthaiks <kitynska@gmail.com>\n"
 "Language: pl\n"
@@ -276,11 +276,106 @@ msgstr ""
 "Przejrzyj dokumentację wiersza poleceń, uruchamiając ``onionshare "
 "--help``::"
 
-#: ../../source/advanced.rst:171
+#: ../../source/advanced.rst:170
+msgid "Running the CLI as a systemd unit file"
+msgstr ""
+
+#: ../../source/advanced.rst:172
+msgid ""
+"It is possible to automatically start OnionShare from the CLI using a "
+"systemd unit file."
+msgstr ""
+
+#: ../../source/advanced.rst:174
+msgid ""
+"You may find this particularly useful if you are operating in "
+"'persistent' mode, and want to start the same onion service every time "
+"your machine starts."
+msgstr ""
+
+#: ../../source/advanced.rst:176
+msgid "To do this, you need to prepare some OnionShare json config first."
+msgstr ""
+
+#: ../../source/advanced.rst:178
+msgid ""
+"Here is the main OnionShare config. In this example, it's stored in "
+"``/home/user/.config/onionshare/onionshare.json``. You may need to adjust"
+" some of the settings, but if you already have OnionShare installed, it "
+"probably looks much like this already::"
+msgstr ""
+
+#: ../../source/advanced.rst:207
+msgid ""
+"Notice the 'persistent_tabs' section. We will now create a file at "
+"``/home/user/.config/onionshare/persistent/my-persistent-onion.json``, "
+"that looks like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:247
+msgid ""
+"**Don't actually use this private key, service_id or client_auth keys! "
+"They are shown only as an example. Never share the private_key with "
+"anyone.**"
+msgstr ""
+
+#: ../../source/advanced.rst:249
+msgid ""
+"The easiest way to generate the onion address and private key is to first"
+" create a 'pinned' OnionShare tab in the desktop app and started the "
+"share for the first time. This will then have saved the persistent "
+"settings to your ``.config/onionshare/persistent/`` folder with a random "
+"name. You can unpin that tab once you've generated it the first time. Or,"
+" you can leave it where it is, and use that persistent file in your "
+"systemd unit file below."
+msgstr ""
+
+#: ../../source/advanced.rst:251
+msgid ""
+"Now you can create a systemd unit file in ``/etc/systemd/system"
+"/onionshare-cli.service``. Be sure to adjust the User and Group to your "
+"own user/group, as well as changes to any paths to the onionshare-cli "
+"binary or the paths to your JSON configs and shares."
+msgstr ""
+
+#: ../../source/advanced.rst:253
+msgid "The systemd unit file should look like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:268
+msgid ""
+"Note that although ``/home/user/my-shared-file.txt`` was defined in the "
+"``filenames`` section of the ``my-persistent-onion.json`` file, it's "
+"still necessary to specify it as the argument to the onionshare-cli "
+"command."
+msgstr ""
+
+#: ../../source/advanced.rst:270
+msgid ""
+"Be sure to run ``sudo systemctl daemon-reload`` after creating the unit "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:272
+msgid ""
+"Now you can run ``sudo systemctl start onionshare-cli.service``. If you "
+"have ``journalctl`` installed, you can run ``sudo journalctl -f -t "
+"onionshare-cli``, and you should see some output of your service "
+"starting::"
+msgstr ""
+
+#: ../../source/advanced.rst:282
+msgid ""
+"If you don't want your users to use a Private Key, set ``public`` to be "
+"``true`` in the ``general`` settings of the my-persistent-onion.json "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:286
 msgid "Keyboard Shortcuts"
 msgstr "Skróty klawiszowe"
 
-#: ../../source/advanced.rst:173
+#: ../../source/advanced.rst:288
 msgid ""
 "The OnionShare desktop application contains some keyboard shortcuts, for "
 "convenience and accessibility::"
@@ -288,36 +383,36 @@ msgstr ""
 "Aplikacja komputerowa OnionShare zawiera kilka skrótów klawiszowych dla "
 "wygody i dostępności:"
 
-#: ../../source/advanced.rst:178
+#: ../../source/advanced.rst:293
 msgid "And from the main mode chooser screen::"
 msgstr "Natomiast z głównego ekranu wyboru trybu:"
 
-#: ../../source/advanced.rst:188
+#: ../../source/advanced.rst:303
 msgid "Migrating your OnionShare data to another computer"
 msgstr ""
 
-#: ../../source/advanced.rst:190
+#: ../../source/advanced.rst:305
 msgid ""
 "You may want to migrate your OnionShare data when switching to another "
 "computer. This is especially true if you had a 'persistent' onion address"
 " and you want to preserve it."
 msgstr ""
 
-#: ../../source/advanced.rst:192
+#: ../../source/advanced.rst:307
 msgid ""
 "OnionShare stores all such data in a specific folder. Copy the relevant "
 "folder for your operating system below, to your new computer:"
 msgstr ""
 
-#: ../../source/advanced.rst:194
+#: ../../source/advanced.rst:309
 msgid "Linux: ``~/.config/onionshare``"
 msgstr ""
 
-#: ../../source/advanced.rst:195
+#: ../../source/advanced.rst:310
 msgid "macOS: ``~/Library/Application Support/OnionShare``"
 msgstr ""
 
-#: ../../source/advanced.rst:196
+#: ../../source/advanced.rst:311
 msgid "Windows: ``%APPDATA%\\OnionShare``"
 msgstr ""
 
@@ -451,3 +546,11 @@ msgstr ""
 #~ "``%APPDATA%\\OnionShare``"
 #~ msgstr ""
 
+#~ msgid ""
+#~ "__Don't actually use this private key,"
+#~ " service_id or client_auth keys! They "
+#~ "are shown only as an example. "
+#~ "Never share the private_key with "
+#~ "anyone.__"
+#~ msgstr ""
+

docs/source/locale/ru/LC_MESSAGES/advanced.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: OnionShare 2.3\n"
 "Report-Msgid-Bugs-To: onionshare-dev@lists.riseup.net\n"
-"POT-Creation-Date: 2025-02-09 09:47+1100\n"
+"POT-Creation-Date: 2025-02-09 10:21+1100\n"
 "PO-Revision-Date: 2024-05-02 15:07+0000\n"
 "Last-Translator: gfbdrgng <hnaofegnp@hldrive.com>\n"
 "Language: ru\n"
@@ -278,11 +278,106 @@ msgstr ""
 "Просмотрите документацию по командной строке, запустив ``onionshare "
 "--help``::"
 
-#: ../../source/advanced.rst:171
+#: ../../source/advanced.rst:170
+msgid "Running the CLI as a systemd unit file"
+msgstr ""
+
+#: ../../source/advanced.rst:172
+msgid ""
+"It is possible to automatically start OnionShare from the CLI using a "
+"systemd unit file."
+msgstr ""
+
+#: ../../source/advanced.rst:174
+msgid ""
+"You may find this particularly useful if you are operating in "
+"'persistent' mode, and want to start the same onion service every time "
+"your machine starts."
+msgstr ""
+
+#: ../../source/advanced.rst:176
+msgid "To do this, you need to prepare some OnionShare json config first."
+msgstr ""
+
+#: ../../source/advanced.rst:178
+msgid ""
+"Here is the main OnionShare config. In this example, it's stored in "
+"``/home/user/.config/onionshare/onionshare.json``. You may need to adjust"
+" some of the settings, but if you already have OnionShare installed, it "
+"probably looks much like this already::"
+msgstr ""
+
+#: ../../source/advanced.rst:207
+msgid ""
+"Notice the 'persistent_tabs' section. We will now create a file at "
+"``/home/user/.config/onionshare/persistent/my-persistent-onion.json``, "
+"that looks like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:247
+msgid ""
+"**Don't actually use this private key, service_id or client_auth keys! "
+"They are shown only as an example. Never share the private_key with "
+"anyone.**"
+msgstr ""
+
+#: ../../source/advanced.rst:249
+msgid ""
+"The easiest way to generate the onion address and private key is to first"
+" create a 'pinned' OnionShare tab in the desktop app and started the "
+"share for the first time. This will then have saved the persistent "
+"settings to your ``.config/onionshare/persistent/`` folder with a random "
+"name. You can unpin that tab once you've generated it the first time. Or,"
+" you can leave it where it is, and use that persistent file in your "
+"systemd unit file below."
+msgstr ""
+
+#: ../../source/advanced.rst:251
+msgid ""
+"Now you can create a systemd unit file in ``/etc/systemd/system"
+"/onionshare-cli.service``. Be sure to adjust the User and Group to your "
+"own user/group, as well as changes to any paths to the onionshare-cli "
+"binary or the paths to your JSON configs and shares."
+msgstr ""
+
+#: ../../source/advanced.rst:253
+msgid "The systemd unit file should look like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:268
+msgid ""
+"Note that although ``/home/user/my-shared-file.txt`` was defined in the "
+"``filenames`` section of the ``my-persistent-onion.json`` file, it's "
+"still necessary to specify it as the argument to the onionshare-cli "
+"command."
+msgstr ""
+
+#: ../../source/advanced.rst:270
+msgid ""
+"Be sure to run ``sudo systemctl daemon-reload`` after creating the unit "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:272
+msgid ""
+"Now you can run ``sudo systemctl start onionshare-cli.service``. If you "
+"have ``journalctl`` installed, you can run ``sudo journalctl -f -t "
+"onionshare-cli``, and you should see some output of your service "
+"starting::"
+msgstr ""
+
+#: ../../source/advanced.rst:282
+msgid ""
+"If you don't want your users to use a Private Key, set ``public`` to be "
+"``true`` in the ``general`` settings of the my-persistent-onion.json "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:286
 msgid "Keyboard Shortcuts"
 msgstr "Горячие клавиши"
 
-#: ../../source/advanced.rst:173
+#: ../../source/advanced.rst:288
 msgid ""
 "The OnionShare desktop application contains some keyboard shortcuts, for "
 "convenience and accessibility::"
@@ -290,36 +385,36 @@ msgstr ""
 "Настольное приложение OnionShare содержит несколько сочетаний клавиш для "
 "удобства и доступности::"
 
-#: ../../source/advanced.rst:178
+#: ../../source/advanced.rst:293
 msgid "And from the main mode chooser screen::"
 msgstr "А на главном экране выбора режима::"
 
-#: ../../source/advanced.rst:188
+#: ../../source/advanced.rst:303
 msgid "Migrating your OnionShare data to another computer"
 msgstr ""
 
-#: ../../source/advanced.rst:190
+#: ../../source/advanced.rst:305
 msgid ""
 "You may want to migrate your OnionShare data when switching to another "
 "computer. This is especially true if you had a 'persistent' onion address"
 " and you want to preserve it."
 msgstr ""
 
-#: ../../source/advanced.rst:192
+#: ../../source/advanced.rst:307
 msgid ""
 "OnionShare stores all such data in a specific folder. Copy the relevant "
 "folder for your operating system below, to your new computer:"
 msgstr ""
 
-#: ../../source/advanced.rst:194
+#: ../../source/advanced.rst:309
 msgid "Linux: ``~/.config/onionshare``"
 msgstr ""
 
-#: ../../source/advanced.rst:195
+#: ../../source/advanced.rst:310
 msgid "macOS: ``~/Library/Application Support/OnionShare``"
 msgstr ""
 
-#: ../../source/advanced.rst:196
+#: ../../source/advanced.rst:311
 msgid "Windows: ``%APPDATA%\\OnionShare``"
 msgstr ""
 
@@ -564,3 +659,11 @@ msgstr ""
 #~ "``%APPDATA%\\OnionShare``"
 #~ msgstr ""
 
+#~ msgid ""
+#~ "__Don't actually use this private key,"
+#~ " service_id or client_auth keys! They "
+#~ "are shown only as an example. "
+#~ "Never share the private_key with "
+#~ "anyone.__"
+#~ msgstr ""
+

docs/source/locale/tr/LC_MESSAGES/advanced.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: OnionShare 2.3\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-02-09 09:47+1100\n"
+"POT-Creation-Date: 2025-02-09 10:21+1100\n"
 "PO-Revision-Date: 2022-10-03 23:25+0000\n"
 "Last-Translator: Oğuz Ersen <oguz@ersen.moe>\n"
 "Language: tr\n"
@@ -275,11 +275,106 @@ msgstr ""
 "``onionshare --help`` komutunu çalıştırarak komut satırı belgelerine göz "
 "atın::"
 
-#: ../../source/advanced.rst:171
+#: ../../source/advanced.rst:170
+msgid "Running the CLI as a systemd unit file"
+msgstr ""
+
+#: ../../source/advanced.rst:172
+msgid ""
+"It is possible to automatically start OnionShare from the CLI using a "
+"systemd unit file."
+msgstr ""
+
+#: ../../source/advanced.rst:174
+msgid ""
+"You may find this particularly useful if you are operating in "
+"'persistent' mode, and want to start the same onion service every time "
+"your machine starts."
+msgstr ""
+
+#: ../../source/advanced.rst:176
+msgid "To do this, you need to prepare some OnionShare json config first."
+msgstr ""
+
+#: ../../source/advanced.rst:178
+msgid ""
+"Here is the main OnionShare config. In this example, it's stored in "
+"``/home/user/.config/onionshare/onionshare.json``. You may need to adjust"
+" some of the settings, but if you already have OnionShare installed, it "
+"probably looks much like this already::"
+msgstr ""
+
+#: ../../source/advanced.rst:207
+msgid ""
+"Notice the 'persistent_tabs' section. We will now create a file at "
+"``/home/user/.config/onionshare/persistent/my-persistent-onion.json``, "
+"that looks like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:247
+msgid ""
+"**Don't actually use this private key, service_id or client_auth keys! "
+"They are shown only as an example. Never share the private_key with "
+"anyone.**"
+msgstr ""
+
+#: ../../source/advanced.rst:249
+msgid ""
+"The easiest way to generate the onion address and private key is to first"
+" create a 'pinned' OnionShare tab in the desktop app and started the "
+"share for the first time. This will then have saved the persistent "
+"settings to your ``.config/onionshare/persistent/`` folder with a random "
+"name. You can unpin that tab once you've generated it the first time. Or,"
+" you can leave it where it is, and use that persistent file in your "
+"systemd unit file below."
+msgstr ""
+
+#: ../../source/advanced.rst:251
+msgid ""
+"Now you can create a systemd unit file in ``/etc/systemd/system"
+"/onionshare-cli.service``. Be sure to adjust the User and Group to your "
+"own user/group, as well as changes to any paths to the onionshare-cli "
+"binary or the paths to your JSON configs and shares."
+msgstr ""
+
+#: ../../source/advanced.rst:253
+msgid "The systemd unit file should look like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:268
+msgid ""
+"Note that although ``/home/user/my-shared-file.txt`` was defined in the "
+"``filenames`` section of the ``my-persistent-onion.json`` file, it's "
+"still necessary to specify it as the argument to the onionshare-cli "
+"command."
+msgstr ""
+
+#: ../../source/advanced.rst:270
+msgid ""
+"Be sure to run ``sudo systemctl daemon-reload`` after creating the unit "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:272
+msgid ""
+"Now you can run ``sudo systemctl start onionshare-cli.service``. If you "
+"have ``journalctl`` installed, you can run ``sudo journalctl -f -t "
+"onionshare-cli``, and you should see some output of your service "
+"starting::"
+msgstr ""
+
+#: ../../source/advanced.rst:282
+msgid ""
+"If you don't want your users to use a Private Key, set ``public`` to be "
+"``true`` in the ``general`` settings of the my-persistent-onion.json "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:286
 msgid "Keyboard Shortcuts"
 msgstr "Klavye Kısayolları"
 
-#: ../../source/advanced.rst:173
+#: ../../source/advanced.rst:288
 msgid ""
 "The OnionShare desktop application contains some keyboard shortcuts, for "
 "convenience and accessibility::"
@@ -287,36 +382,36 @@ msgstr ""
 "OnionShare masaüstü uygulaması, kolaylık ve erişilebilirlik için bazı "
 "klavye kısayolları içerir::"
 
-#: ../../source/advanced.rst:178
+#: ../../source/advanced.rst:293
 msgid "And from the main mode chooser screen::"
 msgstr "Ve ana mod seçici ekranından::"
 
-#: ../../source/advanced.rst:188
+#: ../../source/advanced.rst:303
 msgid "Migrating your OnionShare data to another computer"
 msgstr ""
 
-#: ../../source/advanced.rst:190
+#: ../../source/advanced.rst:305
 msgid ""
 "You may want to migrate your OnionShare data when switching to another "
 "computer. This is especially true if you had a 'persistent' onion address"
 " and you want to preserve it."
 msgstr ""
 
-#: ../../source/advanced.rst:192
+#: ../../source/advanced.rst:307
 msgid ""
 "OnionShare stores all such data in a specific folder. Copy the relevant "
 "folder for your operating system below, to your new computer:"
 msgstr ""
 
-#: ../../source/advanced.rst:194
+#: ../../source/advanced.rst:309
 msgid "Linux: ``~/.config/onionshare``"
 msgstr ""
 
-#: ../../source/advanced.rst:195
+#: ../../source/advanced.rst:310
 msgid "macOS: ``~/Library/Application Support/OnionShare``"
 msgstr ""
 
-#: ../../source/advanced.rst:196
+#: ../../source/advanced.rst:311
 msgid "Windows: ``%APPDATA%\\OnionShare``"
 msgstr ""
 
@@ -582,3 +677,11 @@ msgstr ""
 #~ "``%APPDATA%\\OnionShare``"
 #~ msgstr ""
 
+#~ msgid ""
+#~ "__Don't actually use this private key,"
+#~ " service_id or client_auth keys! They "
+#~ "are shown only as an example. "
+#~ "Never share the private_key with "
+#~ "anyone.__"
+#~ msgstr ""
+

docs/source/locale/uk/LC_MESSAGES/advanced.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: OnionShare 2.3\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-02-09 09:47+1100\n"
+"POT-Creation-Date: 2025-02-09 10:21+1100\n"
 "PO-Revision-Date: 2022-10-03 23:25+0000\n"
 "Last-Translator: Ihor Hordiichuk <igor_ck@outlook.com>\n"
 "Language: uk\n"
@@ -272,11 +272,106 @@ msgstr ""
 "Перегляньте документацію командного рядка, запустивши ``onionshare "
 "--help``::"
 
-#: ../../source/advanced.rst:171
+#: ../../source/advanced.rst:170
+msgid "Running the CLI as a systemd unit file"
+msgstr ""
+
+#: ../../source/advanced.rst:172
+msgid ""
+"It is possible to automatically start OnionShare from the CLI using a "
+"systemd unit file."
+msgstr ""
+
+#: ../../source/advanced.rst:174
+msgid ""
+"You may find this particularly useful if you are operating in "
+"'persistent' mode, and want to start the same onion service every time "
+"your machine starts."
+msgstr ""
+
+#: ../../source/advanced.rst:176
+msgid "To do this, you need to prepare some OnionShare json config first."
+msgstr ""
+
+#: ../../source/advanced.rst:178
+msgid ""
+"Here is the main OnionShare config. In this example, it's stored in "
+"``/home/user/.config/onionshare/onionshare.json``. You may need to adjust"
+" some of the settings, but if you already have OnionShare installed, it "
+"probably looks much like this already::"
+msgstr ""
+
+#: ../../source/advanced.rst:207
+msgid ""
+"Notice the 'persistent_tabs' section. We will now create a file at "
+"``/home/user/.config/onionshare/persistent/my-persistent-onion.json``, "
+"that looks like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:247
+msgid ""
+"**Don't actually use this private key, service_id or client_auth keys! "
+"They are shown only as an example. Never share the private_key with "
+"anyone.**"
+msgstr ""
+
+#: ../../source/advanced.rst:249
+msgid ""
+"The easiest way to generate the onion address and private key is to first"
+" create a 'pinned' OnionShare tab in the desktop app and started the "
+"share for the first time. This will then have saved the persistent "
+"settings to your ``.config/onionshare/persistent/`` folder with a random "
+"name. You can unpin that tab once you've generated it the first time. Or,"
+" you can leave it where it is, and use that persistent file in your "
+"systemd unit file below."
+msgstr ""
+
+#: ../../source/advanced.rst:251
+msgid ""
+"Now you can create a systemd unit file in ``/etc/systemd/system"
+"/onionshare-cli.service``. Be sure to adjust the User and Group to your "
+"own user/group, as well as changes to any paths to the onionshare-cli "
+"binary or the paths to your JSON configs and shares."
+msgstr ""
+
+#: ../../source/advanced.rst:253
+msgid "The systemd unit file should look like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:268
+msgid ""
+"Note that although ``/home/user/my-shared-file.txt`` was defined in the "
+"``filenames`` section of the ``my-persistent-onion.json`` file, it's "
+"still necessary to specify it as the argument to the onionshare-cli "
+"command."
+msgstr ""
+
+#: ../../source/advanced.rst:270
+msgid ""
+"Be sure to run ``sudo systemctl daemon-reload`` after creating the unit "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:272
+msgid ""
+"Now you can run ``sudo systemctl start onionshare-cli.service``. If you "
+"have ``journalctl`` installed, you can run ``sudo journalctl -f -t "
+"onionshare-cli``, and you should see some output of your service "
+"starting::"
+msgstr ""
+
+#: ../../source/advanced.rst:282
+msgid ""
+"If you don't want your users to use a Private Key, set ``public`` to be "
+"``true`` in the ``general`` settings of the my-persistent-onion.json "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:286
 msgid "Keyboard Shortcuts"
 msgstr "Комбінації клавіш"
 
-#: ../../source/advanced.rst:173
+#: ../../source/advanced.rst:288
 msgid ""
 "The OnionShare desktop application contains some keyboard shortcuts, for "
 "convenience and accessibility::"
@@ -284,36 +379,36 @@ msgstr ""
 "Застосунок для комп'ютера OnionShare містить кілька комбінацій клавіш для"
 " зручності та доступності::"
 
-#: ../../source/advanced.rst:178
+#: ../../source/advanced.rst:293
 msgid "And from the main mode chooser screen::"
 msgstr "І з головного екрана вибору режиму::"
 
-#: ../../source/advanced.rst:188
+#: ../../source/advanced.rst:303
 msgid "Migrating your OnionShare data to another computer"
 msgstr ""
 
-#: ../../source/advanced.rst:190
+#: ../../source/advanced.rst:305
 msgid ""
 "You may want to migrate your OnionShare data when switching to another "
 "computer. This is especially true if you had a 'persistent' onion address"
 " and you want to preserve it."
 msgstr ""
 
-#: ../../source/advanced.rst:192
+#: ../../source/advanced.rst:307
 msgid ""
 "OnionShare stores all such data in a specific folder. Copy the relevant "
 "folder for your operating system below, to your new computer:"
 msgstr ""
 
-#: ../../source/advanced.rst:194
+#: ../../source/advanced.rst:309
 msgid "Linux: ``~/.config/onionshare``"
 msgstr ""
 
-#: ../../source/advanced.rst:195
+#: ../../source/advanced.rst:310
 msgid "macOS: ``~/Library/Application Support/OnionShare``"
 msgstr ""
 
-#: ../../source/advanced.rst:196
+#: ../../source/advanced.rst:311
 msgid "Windows: ``%APPDATA%\\OnionShare``"
 msgstr ""
 

docs/source/locale/vi/LC_MESSAGES/advanced.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: OnionShare 2.6\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-02-09 09:47+1100\n"
+"POT-Creation-Date: 2025-02-09 10:21+1100\n"
 "PO-Revision-Date: 2023-02-22 11:40+0000\n"
 "Last-Translator: tictactoe <phandinhminh@protonmail.ch>\n"
 "Language: vi\n"
@@ -274,11 +274,106 @@ msgstr "Sử dụng"
 msgid "Browse the command-line documentation by running ``onionshare --help``::"
 msgstr "Duyệt tài liệu dòng lệnh Command bằng cách chạy ``onionshare --help``::"
 
-#: ../../source/advanced.rst:171
+#: ../../source/advanced.rst:170
+msgid "Running the CLI as a systemd unit file"
+msgstr ""
+
+#: ../../source/advanced.rst:172
+msgid ""
+"It is possible to automatically start OnionShare from the CLI using a "
+"systemd unit file."
+msgstr ""
+
+#: ../../source/advanced.rst:174
+msgid ""
+"You may find this particularly useful if you are operating in "
+"'persistent' mode, and want to start the same onion service every time "
+"your machine starts."
+msgstr ""
+
+#: ../../source/advanced.rst:176
+msgid "To do this, you need to prepare some OnionShare json config first."
+msgstr ""
+
+#: ../../source/advanced.rst:178
+msgid ""
+"Here is the main OnionShare config. In this example, it's stored in "
+"``/home/user/.config/onionshare/onionshare.json``. You may need to adjust"
+" some of the settings, but if you already have OnionShare installed, it "
+"probably looks much like this already::"
+msgstr ""
+
+#: ../../source/advanced.rst:207
+msgid ""
+"Notice the 'persistent_tabs' section. We will now create a file at "
+"``/home/user/.config/onionshare/persistent/my-persistent-onion.json``, "
+"that looks like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:247
+msgid ""
+"**Don't actually use this private key, service_id or client_auth keys! "
+"They are shown only as an example. Never share the private_key with "
+"anyone.**"
+msgstr ""
+
+#: ../../source/advanced.rst:249
+msgid ""
+"The easiest way to generate the onion address and private key is to first"
+" create a 'pinned' OnionShare tab in the desktop app and started the "
+"share for the first time. This will then have saved the persistent "
+"settings to your ``.config/onionshare/persistent/`` folder with a random "
+"name. You can unpin that tab once you've generated it the first time. Or,"
+" you can leave it where it is, and use that persistent file in your "
+"systemd unit file below."
+msgstr ""
+
+#: ../../source/advanced.rst:251
+msgid ""
+"Now you can create a systemd unit file in ``/etc/systemd/system"
+"/onionshare-cli.service``. Be sure to adjust the User and Group to your "
+"own user/group, as well as changes to any paths to the onionshare-cli "
+"binary or the paths to your JSON configs and shares."
+msgstr ""
+
+#: ../../source/advanced.rst:253
+msgid "The systemd unit file should look like this::"
+msgstr ""
+
+#: ../../source/advanced.rst:268
+msgid ""
+"Note that although ``/home/user/my-shared-file.txt`` was defined in the "
+"``filenames`` section of the ``my-persistent-onion.json`` file, it's "
+"still necessary to specify it as the argument to the onionshare-cli "
+"command."
+msgstr ""
+
+#: ../../source/advanced.rst:270
+msgid ""
+"Be sure to run ``sudo systemctl daemon-reload`` after creating the unit "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:272
+msgid ""
+"Now you can run ``sudo systemctl start onionshare-cli.service``. If you "
+"have ``journalctl`` installed, you can run ``sudo journalctl -f -t "
+"onionshare-cli``, and you should see some output of your service "
+"starting::"
+msgstr ""
+
+#: ../../source/advanced.rst:282
+msgid ""
+"If you don't want your users to use a Private Key, set ``public`` to be "
+"``true`` in the ``general`` settings of the my-persistent-onion.json "
+"file."
+msgstr ""
+
+#: ../../source/advanced.rst:286
 msgid "Keyboard Shortcuts"
 msgstr "Các phím tắt bàn phím"
 
-#: ../../source/advanced.rst:173
+#: ../../source/advanced.rst:288
 msgid ""
 "The OnionShare desktop application contains some keyboard shortcuts, for "
 "convenience and accessibility::"
@@ -286,36 +381,36 @@ msgstr ""
 "Ứng dụng máy tính desktop OnionShare có chứa một số phím tắt bàn phím, để"
 " giúp thuận tiện và khả năng truy cập::"
 
-#: ../../source/advanced.rst:178
+#: ../../source/advanced.rst:293
 msgid "And from the main mode chooser screen::"
 msgstr "Và từ màn hình chọn chế độ chính::"
 
-#: ../../source/advanced.rst:188
+#: ../../source/advanced.rst:303
 msgid "Migrating your OnionShare data to another computer"
 msgstr ""
 
-#: ../../source/advanced.rst:190
+#: ../../source/advanced.rst:305
 msgid ""
 "You may want to migrate your OnionShare data when switching to another "
 "computer. This is especially true if you had a 'persistent' onion address"
 " and you want to preserve it."
 msgstr ""
 
-#: ../../source/advanced.rst:192
+#: ../../source/advanced.rst:307
 msgid ""
 "OnionShare stores all such data in a specific folder. Copy the relevant "
 "folder for your operating system below, to your new computer:"
 msgstr ""
 
-#: ../../source/advanced.rst:194
+#: ../../source/advanced.rst:309
 msgid "Linux: ``~/.config/onionshare``"
 msgstr ""
 
-#: ../../source/advanced.rst:195
+#: ../../source/advanced.rst:310
 msgid "macOS: ``~/Library/Application Support/OnionShare``"
 msgstr ""
 
-#: ../../source/advanced.rst:196
+#: ../../source/advanced.rst:311
 msgid "Windows: ``%APPDATA%\\OnionShare``"
 msgstr ""
 
@@ -325,3 +420,11 @@ msgstr ""
 #~ "``%APPDATA%\\OnionShare``"
 #~ msgstr ""
 
+#~ msgid ""
+#~ "__Don't actually use this private key,"
+#~ " service_id or client_auth keys! They "
+#~ "are shown only as an example. "
+#~ "Never share the private_key with "
+#~ "anyone.__"
+#~ msgstr ""
+