Skip to content

Commit 8720335

Browse files
committed
docs: easier multi-instance config tip
1 parent c86cccb commit 8720335

File tree

1 file changed

+11
-1
lines changed

1 file changed

+11
-1
lines changed

docs/howto.rst

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -161,7 +161,7 @@ wholesale, with all the work that comes with that after updates,
161161
you can simply ignore just the ``commands.rc.default`` file,
162162
and replace it with an adapted copy in your *main* configuration file.
163163

164-
So, in summary, to customize a ``~/rtorrent1`` instance:
164+
So, in summary, to customize a :file:`~/rtorrent` instance:
165165

166166
.. code-block:: shell
167167
@@ -173,6 +173,16 @@ So, in summary, to customize a ``~/rtorrent1`` instance:
173173
Now commands like ``s=`` are defined in ``~/rtorrent1/rtorrent.rc``, and
174174
``commands.rc.default`` is not imported, so no duplicate definition errors occur.
175175

176+
.. tip::
177+
178+
Starting with version *0.6.1*, you can use the :envvar:`PYRO_CONFIG_DIR` environment variable
179+
instead, by exporting it in your instance's start script or `systemd` unit.
180+
This allows you to re-use *the same* :file:`~/.pyroscope/rtorrent-pyro.rc.default` include in the main
181+
:file:`rtorrent.rc` of your instance, and work with an unchanged :file:`~/.pyroscope/rtorrent.d/` directory.
182+
183+
This variable, the :term:`cfg.basedir` value, and its current directory then allow
184+
the started :command:`rtorrent` process to find the right files and directories.
185+
176186

177187
.. _move-data:
178188

0 commit comments

Comments
 (0)