BlendLuxCore Installation - Revision history

CodeHD: Update example files for offline installation.

2025-04-28T09:58:13Z

Update example files for offline installation.

← Older revision		Revision as of 11:58, 28 April 2025
Line 70:		Line 70:

	In addition to the BlendLuxCore zip-file itself (see [[#Downloading \| Downloading]]), you need to have the python-wheel of pyluxcore, and any further python-wheels that are dependencies, in the a appropriate version for your platform.		In addition to the BlendLuxCore zip-file itself (see [[#Downloading \| Downloading]]), you need to have the python-wheel of pyluxcore, and any further python-wheels that are dependencies, in the a appropriate version for your platform.
	For BlendLuxCore v2.10.0-~~alpha~~.2, these will be:
	* pyluxcore-2.10.~~0a2~~		Example: For BlendLuxCore v2.10.0-rc.1, these will be:
	* numpy-2.2.4		* pyluxcore-2.10.0
			* numpy-2.2.5
	* nvidia_cuda_nvrtc_cu12-12.8.93		* nvidia_cuda_nvrtc_cu12-12.8.93

			Example part 2: For Windows, you are looking for download links like the following:

			[https://files.pythonhosted.org/packages/21/5b/76599c040e0873dd14885850f0e35d1d314f8abdf01200ebeb0b75422161/pyluxcore-2.10.0-cp311-cp311-win_amd64.whl pyluxcore]

			[https://files.pythonhosted.org/packages/98/89/0c93baaf0094bdaaaa0536fe61a27b1dce8a505fa262a865ec142208cfe9/numpy-2.2.5-cp311-cp311-win_amd64.whl numpy]

			[https://files.pythonhosted.org/packages/45/51/52a3d84baa2136cc8df15500ad731d74d3a1114d4c123e043cb608d4a32b/nvidia_cuda_nvrtc_cu12-12.8.93-py3-none-win_amd64.whl nvidia-cuda-nvrtc]

	You can search and download these manually from [https://pypi.org PyPi], or copy them from another computer where the installation was successful. In the latter case, you should find the files in the wheels/ subdirectory of the extension installaton path (see [[#Testing_Experimental_Versions \| Testing Experimental Versions]]).		You can search and download these manually from [https://pypi.org PyPi], or copy them from another computer where the installation was successful. In the latter case, you should find the files in the wheels/ subdirectory of the extension installaton path (see [[#Testing_Experimental_Versions \| Testing Experimental Versions]]).

CodeHD at 12:01, 13 April 2025

2025-04-13T12:01:14Z

← Older revision		Revision as of 14:01, 13 April 2025
Line 87:		Line 87:
	* pyluxcore should now be installed. The install_offline/ directory will be deleted automatically if the installation was successful.		* pyluxcore should now be installed. The install_offline/ directory will be deleted automatically if the installation was successful.
	* Close and reopen Blender, and select LuxCoreRender as the rendering engine to verify that everythig works correctly.		* Close and reopen Blender, and select LuxCoreRender as the rendering engine to verify that everythig works correctly.

			[[ File:BlendLuxCore_activate.png \| 786px ]]

	== Common Problems and Errors ==		== Common Problems and Errors ==

CodeHD at 12:00, 13 April 2025

2025-04-13T12:00:03Z

← Older revision		Revision as of 14:00, 13 April 2025
Line 47:		Line 47:

	For the latest version of BlendLuxCore:		For the latest version of BlendLuxCore:
	* download the [https://github.com/LuxCoreRender/BlendLuxCore/releases/tag/latest\|"Latest"] release in GitHub and install it following the instructions in [[#How_to_Update\|How to Update]] and [[#Installation\|Installation]].		* download the [https://github.com/LuxCoreRender/BlendLuxCore/releases/tag/latest "Latest"] release in GitHub and install it following the instructions in [[#How_to_Update\|How to Update]] and [[#Installation\|Installation]].
	* Note: This version will still install a (pre-configured) official release of pyluxcore, NOT its latest build.		* Note: This version will still install a (pre-configured) official release of pyluxcore, NOT its latest build.

	To also get the latest version of pyluxcore:		To also get the latest version of pyluxcore:
	* You will need an account on GitHub and log in.		* You will need an account on GitHub and log in.
	* Go to the [https://github.com/LuxCoreRender/LuxCore/actions\|Actions] page of the LuxCore repository.		* Go to the [https://github.com/LuxCoreRender/LuxCore/actions Actions] page of the LuxCore repository.
	* Click on the latest workflow run. If you are in doubt which one is suitable, please ask in one of the support or community channels.		* Click on the latest workflow run. If you are in doubt which one is suitable, please ask in one of the support or community channels.
	* At the bottom of the page, you find the "Artifacts" section.		* At the bottom of the page, you find the "Artifacts" section.
Line 64:		Line 64:
	* Note: there must only be one .whl file in the pyluxcore_custom/ folder at any time!		* Note: there must only be one .whl file in the pyluxcore_custom/ folder at any time!
	* When you empty the pyluxcore_custom/ folder, the pre-defined release version will be installed again.		* When you empty the pyluxcore_custom/ folder, the pre-defined release version will be installed again.

			== Offline Installation ==

			It is possible to install BlendLuxCore wihtout internet access, or in an environment where the regular installation method is blocked for network security reasons (i.e. some company networks).

			In addition to the BlendLuxCore zip-file itself (see [[#Downloading \| Downloading]]), you need to have the python-wheel of pyluxcore, and any further python-wheels that are dependencies, in the a appropriate version for your platform.
			For BlendLuxCore v2.10.0-alpha.2, these will be:
			* pyluxcore-2.10.0a2
			* numpy-2.2.4
			* nvidia_cuda_nvrtc_cu12-12.8.93

			You can search and download these manually from [https://pypi.org PyPi], or copy them from another computer where the installation was successful. In the latter case, you should find the files in the wheels/ subdirectory of the extension installaton path (see [[#Testing_Experimental_Versions \| Testing Experimental Versions]]).

			Once you have obtained the files, follow these steps:
			* Install the addon as described in [[#Installation \| Installation]]. This will fail to import pyluxcore, as expected, but create the extensions directory required for the next steps.<br>In Blender, the BlendLuxCore addon will be shown as installed, but disabled.
			* Close Blender.
			* Create a subdirectoy install_offline/ in the extension folder.
			* Place the python-wheels in the install_offline/ subdirectory.
			* Open Blender.
			* Open the preferences menu, go to the Add-Ons tab.
			* Activate BlendLuxCore by clicking the checkbox next to the BlendLuxCore item (see image).
			* pyluxcore should now be installed. The install_offline/ directory will be deleted automatically if the installation was successful.
			* Close and reopen Blender, and select LuxCoreRender as the rendering engine to verify that everythig works correctly.

	== Common Problems and Errors ==		== Common Problems and Errors ==

CodeHD at 22:23, 10 April 2025

2025-04-10T22:23:11Z

@@ Line 34: / Line 34: @@
 * Click on the arrow to the right of the BlendLuxCore item to open up the actions menu.
 * Click on "Uninstall".
 == Common Problems and Errors ==

CodeHD at 21:42, 10 April 2025

2025-04-10T21:42:38Z

@@ Line 1: / Line 1: @@
 == Downloading ==
-* Visit [https://luxcorerender.org/download/ the download page] to download a zip archive for one of the latest versions.
+* Visit [https://luxcorerender.org/download/ the download page] to find the latest release versions.
 * Older versions of BlendLuxCore can be found on [https://github.com/LuxCoreRender/BlendLuxCore/releases the GitHub releases page].
 == Installation ==
 Follow the official Blender instructions for [https://docs.blender.org/manual/en/4.2/editors/preferences/extensions.html#get-extensions installing an extension]. Follow the steps for "Install from Disk":
@@ Line 21: / Line 25: @@
 [[ File:Install-2.10-2.png | 733px ]]
-== Common Problems and Errors ==
+== How to Update ==
-== Legacy: Installation ==
+To update BlendLuxCore, you need to first uninstall the current version and then install the new version as outlined in section [[#Installation|Installation]].
-If you are trying to install older versions of BlendLuxCore (< v2.10) on older versions of Blender (< v4.0), the following instructions might provide you with some additional insight.
+To uninstall:
-* Follow the [https://docs.blender.org/manual/en/dev/editors/preferences/addons.html#rd-party-add-ons Blender Manual] (open user preferences, choose "install from file", select the downloaded .zip archive, click open, enable the addon in the list)
+== Common Problems and Errors ==
 [[Category:BlendLuxCore]]

CodeHD at 23:15, 27 March 2025

2025-03-27T23:15:02Z

← Older revision		Revision as of 01:15, 28 March 2025
Line 1:		Line 1:
	== Downloading ==		== Downloading ==

	* Visit [https://luxcorerender.org/download/ the download page] to download a zip archive for one of the latest ~~version~~.		* Visit [https://luxcorerender.org/download/ the download page] to download a zip archive for one of the latest versions.
	* Older versions of BlendLuxCore can be found on [https://github.com/LuxCoreRender/BlendLuxCore/releases the GitHub releases page].		* Older versions of BlendLuxCore can be found on [https://github.com/LuxCoreRender/BlendLuxCore/releases the GitHub releases page].

	== Installation ==		== Installation ==

	<b>Note: This ~~verison~~ of the guide is valid as of Blender 4.2 LTS and BlendLuxCore v2.10. If you notice any incompatibilities with later versions, please inform the developers thorugh one of the community channels.		<b>Note: This version of the guide is valid as of Blender 4.2 LTS and BlendLuxCore v2.10. If you notice any incompatibilities with later versions, please inform the developers thorugh one of the community channels.
	A guide to install ~~older~~ versions can be found further below </b>		The guide to install legacy versions can be found further below in this article. </b>

	Follow the official Blender instructions for [https://docs.blender.org/manual/en/4.2/editors/preferences/extensions.html#get-extensions installing an extension]. Follow the steps for ~~the~~ "Install from Disk".		Follow the official Blender instructions for [https://docs.blender.org/manual/en/4.2/editors/preferences/extensions.html#get-extensions installing an extension]. Follow the steps for "Install from Disk":
	* Open up the preferences menu ("Edit" -> "Preferences")		* Open up the preferences menu: "Edit" -> "Preferences" (first picture)
	* Go to the "Get Extensions" tab		* Go to the "Get Extensions" tab (second picture)
	* Open the menu in the top right corner and select "Install from disk..."		* Open the menu in the top right corner and select "Install from disk..." (second picture)
	* Select the zip archive. After installation, BlendLuxCore should automatically be activated. You can verify this in the "Add-ons" tab.		* Select the zip archive.
			* After the installation, BlendLuxCore should automatically be activated. You can verify this in the "Add-ons" tab.
			* It is recommended to restart Blender before using BlendLuxCore, to ensure all features are loaded correctly.

	[[ File:Install-2.10-1.png \| 372px ]]		[[ File:Install-2.10-1.png \| 372px ]]

			[[ File:Install-2.10-2.png \| 733px ]]

	== Common Problems and Errors ==		== Common Problems and Errors ==
Line 21:		Line 25:
	Some fixes for common problems are listed in the [https://wiki.luxcorerender.org/BlendLuxCore_FAQ#I_can_not_enable_the_BlendLuxCore_addon.2C_it_shows_errors FAQ].		Some fixes for common problems are listed in the [https://wiki.luxcorerender.org/BlendLuxCore_FAQ#I_can_not_enable_the_BlendLuxCore_addon.2C_it_shows_errors FAQ].

	== Installation ~~- Legacy Versions~~ ==		== Legacy: Installation ==

	If you are trying to install older versions of BlendLuxCore (< v2.10) on older versions of Blender (< v4.0), the following instructions might provide you with some additional insight.		If you are trying to install older versions of BlendLuxCore (< v2.10) on older versions of Blender (< v4.0), the following instructions might provide you with some additional insight.
Line 38:		Line 42:
	Note: the BlendLuxCore addon is fully self-contained and includes all necessary LuxCore binaries, you do not need to install the standalone version of LuxCore.		Note: the BlendLuxCore addon is fully self-contained and includes all necessary LuxCore binaries, you do not need to install the standalone version of LuxCore.

	== How to Update ==		== Legacy: How to Update ==

	Open the Blender user preferences (Ctrl+Alt+U), then enter "luxcore" into the search field and expand the entry so you see all the info and settings of the addon.		Open the Blender user preferences (Ctrl+Alt+U), then enter "luxcore" into the search field and expand the entry so you see all the info and settings of the addon.
Line 66:		Line 70:
	If you have v2.0 installed, you will have to follow the remove steps below, then download the v2.1 release zip package, and follow the install steps on the top of this page.		If you have v2.0 installed, you will have to follow the remove steps below, then download the v2.1 release zip package, and follow the install steps on the top of this page.

	== How to Remove ==		== Legacy: How to Remove ==

	To remove the addon:		To remove the addon:

CodeHD at 23:09, 27 March 2025

2025-03-27T23:09:58Z

← Older revision		Revision as of 01:09, 28 March 2025
Line 16:		Line 16:

	[[ File:Install-2.10-1.png \| 372px ]]		[[ File:Install-2.10-1.png \| 372px ]]

	~~[[ File:Install-2.10-2.png \| 733px ]]~~

	== Common Problems and Errors ==		== Common Problems and Errors ==

CodeHD at 23:08, 27 March 2025

2025-03-27T23:08:55Z

← Older revision		Revision as of 01:08, 28 March 2025
Line 14:		Line 14:
	* Open the menu in the top right corner and select "Install from disk..."		* Open the menu in the top right corner and select "Install from disk..."
	* Select the zip archive. After installation, BlendLuxCore should automatically be activated. You can verify this in the "Add-ons" tab.		* Select the zip archive. After installation, BlendLuxCore should automatically be activated. You can verify this in the "Add-ons" tab.

			[[ File:Install-2.10-1.png \| 372px ]]

			[[ File:Install-2.10-2.png \| 733px ]]

	== Common Problems and Errors ==		== Common Problems and Errors ==

CodeHD at 22:33, 27 March 2025

2025-03-27T22:33:07Z

@@ Line 1: / Line 1: @@
 == Installation ==
-* Visit [https://luxcorerender.org/download/ the download page] and download the zip archive for your platform.
+<b>Note: This verison of the guide is valid as of Blender 4.2 LTS and BlendLuxCore v2.10. If you notice any incompatibilities with later versions, please inform the developers thorugh one of the community channels.
 * Follow the [https://docs.blender.org/manual/en/dev/editors/preferences/addons.html#rd-party-add-ons Blender Manual] (open user preferences, choose "install from file", select the downloaded .zip archive, click open, enable the addon in the list)
 * If you have old LuxRender addon enabled and have troubles activating new LuxCore addon, it would be a good idea to disable LuxRender addon first, save Blender user settings, restart Blender and then try again.
@@ Line 14: / Line 35: @@
 Note: the BlendLuxCore addon is fully self-contained and includes all necessary LuxCore binaries, you do not need to install the standalone version of LuxCore.
 == How to Update ==

Byob at 00:12, 8 September 2019

2019-09-08T00:12:21Z

← Older revision		Revision as of 02:12, 8 September 2019
Line 8:		Line 8:
	'''For version v2.0:'''		'''For version v2.0:'''
	* [https://www.microsoft.com/en-US/download/details.aspx?id=40784 Visual C++ Redistributable Packages for Visual Studio 2013]		* [https://www.microsoft.com/en-US/download/details.aspx?id=40784 Visual C++ Redistributable Packages for Visual Studio 2013]
	'''For version v2.1:'''		'''For version v2.1 and later:'''
	* [https://aka.ms/vs/15/release/vc_redist.x64.exe Microsoft Visual C++ Redistributable for Visual Studio 2017]		* [https://aka.ms/vs/15/release/vc_redist.x64.exe Microsoft Visual C++ Redistributable for Visual Studio 2017]
	* [https://software.intel.com/sites/default/files/managed/59/aa/ww_icl_redist_msi_2018.3.210.zip Intel C++ redistributable]		* [https://software.intel.com/sites/default/files/managed/59/aa/ww_icl_redist_msi_2018.3.210.zip Intel C++ redistributable]