blender/blender-manual
20
22
Fork 99
Code Issues 81 Pull Requests 7 Projects 1 Releases Wiki Activity

Advanced: New Deploying Blender page #104811

Merged
Brecht Van Lommel merged 2 commits from brecht/blender-manual:deploying into blender-v4.2-release 2024-06-07 14:49:37 +02:00
Conversation 0 Commits 2 Files Changed 3 +19 -12
1 changed files with 19 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit 11dcba5391 - Show all commits

31
manual/advanced/deploying_blender.rst
View File

@ -1,8 +1,8 @@
.. _deploying-blender: .. _deploying-blender:
***************** *******************************
Deploying Blender Deploying Blender in Production
***************** *******************************
It is possible to deploy Blender in environments that are more It is possible to deploy Blender in environments that are more
restricted, use automation or have other special requirements. restricted, use automation or have other special requirements.
@ -20,8 +20,8 @@ standard file management tools.
New Blender versions may add, remove or changes functionality that New Blender versions may add, remove or changes functionality that
change the results of production files. For a given project, it is change the results of production files. For a given project, it is
advisable to use a single LTS (long term support) version of Blender. advisable to use a single :abbr:`LTS (Long-Term-Support)` version
LTS versions receive bug fixes for two years. of Blender. LTS versions receive bug fixes for two years.
Working Offline Working Offline
=============== ===============
@ -32,7 +32,8 @@ By default Blender does not access the internet, however this can be
enabled in the System preferences with the Online Access option. enabled in the System preferences with the Online Access option.
Working offline can be enforced by running with the ``--offline-mode`` Working offline can be enforced by running with the ``--offline-mode``
:ref:`command line argument <command-line-args-network-options>`. :ref:`command line argument <command-line-args-network-options>`. Users
will then be unable to enable online access in the preferences.
Bundling Extensions Bundling Extensions
=================== ===================
@ -45,12 +46,15 @@ or in a system directory.
The location of this system extension repository can be manually configured The location of this system extension repository can be manually configured
in the Extensions preferences. in the Extensions preferences.
The ``$BLENDER_SYSTEM_REPOSITORY`` The ``$BLENDER_SYSTEM_EXTENSIONS``
:ref:`environment variable <command-line-args-environment-variables>` :ref:`environment variable <command-line-args-environment-variables>`
can also set the default location. This is a directory, within which a can also set the default location. This is a directory, within which a
``system`` directory should exist. Each extension zip file should be ``system`` directory should exist. Then extract extension packages there,
extracted to its own folder, and which should then contain a with a resulting path like this:
``blender_manifest.toml`` file.
.. code-block:: bash
$BLENDER_SYSTEM_EXTENSIONS/system/my-addon/blender_manifest.toml
Bundling Scripts Bundling Scripts
================ ================
@ -72,8 +76,11 @@ Startup Scripts
The Blender Python API can be used to customize Blender. This includes The Blender Python API can be used to customize Blender. This includes
changing preferences, changing the startup file and adding UI elements. changing preferences, changing the startup file and adding UI elements.
For example a ``startup/enable_addons.py`` script can be created to For example, a script can enable add-ons for every user.
enable a set of add-ons for every user.
.. code-block:: bash
$BLENDER_SYSTEM_SCRIPTS/startup/enable_addons.py
.. code-block:: python .. code-block:: python