Blender - Revision history

Smudgebun: Fix header capitalization to align with Manual of Style

2026-09-03T18:56:11Z

Fix header capitalization to align with Manual of Style

← Older revision		Revision as of 18:56, 3 September 2026
Line 10:		Line 10:
	</syntaxhighlight>		</syntaxhighlight>

	If you want to install Blender with support for compute APIs, see: [[#Advanced ~~Installation~~]]		If you want to install Blender with support for compute APIs, see: [[#Advanced installation]]

	== Configuration ==		== Configuration ==
	=== Installing ~~With Additional~~ Python ~~Packages~~ ===		=== Installing with additional Python packages ===
	To install additional Python modules into Blender, use the <code>withPackages</code> attribute.		To install additional Python modules into Blender, use the <code>withPackages</code> attribute.

Line 74:		Line 74:
	}}		}}

	== Tips ~~& Tricks~~ ==		== Tips and tricks ==

	=== Blendfarm ===		=== Blendfarm ===
Line 91:		Line 91:
	}}		}}

	== Advanced ~~Installation~~ ==		== Advanced installation ==
	* [[#Binary ~~Packages~~]] for Blender binary packages with support for all APIs		* [[#Binary packages]] for Blender binary packages with support for all APIs
	* [[#CUDA & OptiX]] for support for NVIDIA's CUDA & OptiX		* [[#CUDA & OptiX]] for support for NVIDIA's CUDA & OptiX
	* [[#HIP]] for support for AMD's HIP		* [[#HIP]] for support for AMD's HIP
	* [[#oneAPI]] for support for Intel's oneAPI		* [[#oneAPI]] for support for Intel's oneAPI
	* [[#Last ~~Resorts~~]] if all other methods don't work for your situation		* [[#Last resorts]] if all other methods don't work for your situation
	=== Binary ~~Packages~~ ===		=== Binary packages ===
	These are alternative distribution methods that package the Blender binaries, meaning they have support for all APIs.		These are alternative distribution methods that package the Blender binaries, meaning they have support for all APIs.
	==== Steam ====		==== Steam ====
	Installing [https://store.steampowered.com/app/365670/Blender/ Blender through Steam] will run Linux native Blender in the Steam Runtime environment, and it will receive automatic updates through Steam. Note that if you make Steam run the Windows version (through Proton) by selecting "Force the use of a specific Steam Play compatibility tool" under Properties > Compatibility, the APIs will fail as they will not have the relevant Windows drivers.		Installing [https://store.steampowered.com/app/365670/Blender/ Blender through Steam] will run Linux native Blender in the Steam Runtime environment, and it will receive automatic updates through Steam. Note that if you make Steam run the Windows version (through Proton) by selecting "Force the use of a specific Steam Play compatibility tool" under Properties > Compatibility, the APIs will fail as they will not have the relevant Windows drivers.

	==== The blender-bin ~~Flake~~ ====		==== The blender-bin flake ====
	The unofficial [https://github.com/edolstra/nix-warez/tree/master/blender blender-bin] flake, provided by edolstra, packages the binary release of Blender for NixOS, and hosts it on FlakeHub [https://flakehub.com/flake/edolstra/blender-bin?view=usage here]. The following demonstrates how to add the flake to a [[NixOS_system_configuration#Defining_NixOS_as_a_flake\|flake-based configuration]].		The unofficial [https://github.com/edolstra/nix-warez/tree/master/blender blender-bin] flake, provided by edolstra, packages the binary release of Blender for NixOS, and hosts it on FlakeHub [https://flakehub.com/flake/edolstra/blender-bin?view=usage here]. The following demonstrates how to add the flake to a [[NixOS_system_configuration#Defining_NixOS_as_a_flake\|flake-based configuration]].

Line 156:		Line 156:
	Compiling Blender is very resource-intensive, so if you are unable to use a binary cache, please see the associated warning and information in [[CUDA#Enabling CUDA In Packages]].		Compiling Blender is very resource-intensive, so if you are unable to use a binary cache, please see the associated warning and information in [[CUDA#Enabling CUDA In Packages]].

	==== Community ~~Flakes~~ ====		==== Community flakes ====
	In addition to the [[#The blender-bin Flake\|#blender-bin flake]], there is also [https://github.com/adithyagenie/blender-cuda-nixos blender-cuda-nixos], which compiles Blender with <code>cudaSupport</code> enabled and caches it on cachix so you don't need to build it yourself. For the most up-to-date instructions on adding it to your configuration, see its [https://github.com/adithyagenie/blender-cuda-nixos/blob/master/README.md README].		In addition to the [[#The blender-bin Flake\|#blender-bin flake]], there is also [https://github.com/adithyagenie/blender-cuda-nixos blender-cuda-nixos], which compiles Blender with <code>cudaSupport</code> enabled and caches it on cachix so you don't need to build it yourself. For the most up-to-date instructions on adding it to your configuration, see its [https://github.com/adithyagenie/blender-cuda-nixos/blob/master/README.md README].

Line 182:		Line 182:
	Currently, Nixpkgs has extremely limited oneAPI support (see {{issue\|367722\|<nowiki>the tracking issue</nowiki>}}), which is explicitly blocking {{issue\|447245\|Blender oneAPI support}}. As such, the current only way to have oneAPI support on NixOS is through one of the [[#Binary Packages\|#Binary Packages]].		Currently, Nixpkgs has extremely limited oneAPI support (see {{issue\|367722\|<nowiki>the tracking issue</nowiki>}}), which is explicitly blocking {{issue\|447245\|Blender oneAPI support}}. As such, the current only way to have oneAPI support on NixOS is through one of the [[#Binary Packages\|#Binary Packages]].

	=== Last ~~Resorts~~ ===		=== Last resorts ===
	If nothing else works for your situation, you can also download the Blender binary from [https://www.blender.org/download/ blender.org] and run it in NixOS using a program like [[Nix-ld\|nix-ld]] or [https://github.com/thiagokokada/nix-alien nix-alien], patch the binary manually (see: [[Packaging/Binaries]]), or try using a container like [[Distrobox]] (see: [https://distrobox.it/useful_tips/#using-the-gpu-inside-the-container Distrobox: Using the GPU Inside the Container]).		If nothing else works for your situation, you can also download the Blender binary from [https://www.blender.org/download/ blender.org] and run it in NixOS using a program like [[Nix-ld\|nix-ld]] or [https://github.com/thiagokokada/nix-alien nix-alien], patch the binary manually (see: [[Packaging/Binaries]]), or try using a container like [[Distrobox]] (see: [https://distrobox.it/useful_tips/#using-the-gpu-inside-the-container Distrobox: Using the GPU Inside the Container]).

	== Known ~~Issues~~ ==		== Known issues ==

	=== UI is dim on Vulkan backend and KDE Plasma ===		=== UI is dim on Vulkan backend and KDE Plasma ===

Smudgebun: Add to Applications category

2026-07-25T16:49:31Z

Add to Applications category

← Older revision		Revision as of 16:49, 25 July 2026
Line 196:		Line 196:
	== References ==		== References ==
	<references />		<references />

			[[Category:Applications]]

Smudgebun: Fix examples

2026-07-14T03:53:00Z

Fix examples

← Older revision		Revision as of 03:53, 14 July 2026
Line 27:		Line 27:
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	let		let
	blender-cuda = blender.override {config.cudaSupport=true;};		blender-cuda = blender.override {config.cudaSupport=true; config.rocmSupport=false; };
	in {		in {

Line 144:		Line 144:
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	environment.systemPackages = with pkgs; [		environment.systemPackages = with pkgs; [
	(blender.override {config.cudaSupport=true;})		(blender.override {config.cudaSupport=true; config.rocmSupport=false;})

	/* (blender.override {		/* (blender.override {

Smudgebun: /* UI is dim on Vulkan backend and KDE Plasma */ Clean up

2026-05-23T00:13:17Z

UI is dim on Vulkan backend and KDE Plasma: Clean up

← Older revision		Revision as of 00:13, 23 May 2026
Line 189:		Line 189:
	=== UI is dim on Vulkan backend and KDE Plasma ===		=== UI is dim on Vulkan backend and KDE Plasma ===

	~~This is a~~ cross-distro issue on ~~current~~ KDE Plasma with NVIDIA~~, (confirmed issue on KDE Version 6.6.2-6.6.4 Wayland Session with NVIDIA drivers Versions 595.XX, though may affect others too)~~. A workaround option that doesn't require downgrading is to force XWayland by running Blender with the following command. See more information at the related {{issue\|link=https://projects.blender.org/blender/blender/issues/155467\|\|issue}} on Blender's repo.		A cross-distro issue on KDE Plasma with NVIDIA. A workaround option that doesn't require downgrading is to force XWayland by running Blender with the following command. See more information at the related {{issue\|link=https://projects.blender.org/blender/blender/issues/155467\|\|issue}} on Blender's repo.
	<syntaxhighlight lang="sh">		<syntaxhighlight lang="sh">
	WAYLAND_DISPLAY=0 blender		WAYLAND_DISPLAY=0 blender

Smudgebun: /* The cudaSupport Flag */ Slightly changed wording

2026-05-11T19:56:25Z

The cudaSupport Flag: Slightly changed wording

← Older revision		Revision as of 19:56, 11 May 2026
Line 152:		Line 152:
	</syntaxhighlight>		</syntaxhighlight>

	If installing Blender with <code>cudaSupport</code>, it is highly recommended you set up ~~the~~ [[CUDA#Setting up CUDA Binary Cache\|CUDA ~~Binary Cache~~]]. If you do not have it set up, and install Blender with <code>cudaSupport</code>, your machine will be compiling Blender from source.		If installing Blender with <code>cudaSupport</code>, it is highly recommended you set up a [[CUDA#Setting up CUDA Binary Cache\|CUDA binary cache]]. If you do not have one set up, and install Blender with <code>cudaSupport</code>, your machine will be compiling Blender from source.

	Compiling Blender is very resource-intensive, so if you are unable to use ~~the CUDA Cache~~, please see the associated warning and information in [[CUDA#Enabling CUDA In Packages]].		Compiling Blender is very resource-intensive, so if you are unable to use a binary cache, please see the associated warning and information in [[CUDA#Enabling CUDA In Packages]].

	==== Community Flakes ====		==== Community Flakes ====

Sivak: Closed () braces for pieces of code missing a closing )

2026-05-06T01:41:23Z

Closed () braces for pieces of code missing a closing )

← Older revision		Revision as of 01:41, 6 May 2026
Line 20:		Line 20:
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	environment.systemPackages = with pkgs; [		environment.systemPackages = with pkgs; [
	(blender.withPackages(ps: [ ps.pyserial ps.fs ])		(blender.withPackages(ps: [ ps.pyserial ps.fs ]))
	];		];
	</syntaxhighlight>		</syntaxhighlight>
Line 31:		Line 31:

	environment.systemPackages = with pkgs; [		environment.systemPackages = with pkgs; [
	(blender-cuda.withPackages(ps: [ ps.yq ])		(blender-cuda.withPackages(ps: [ ps.yq ]))
	# (pkgsRocm.blender.withPackages(ps: [ ps.pyserial ps.fs ])		# (pkgsRocm.blender.withPackages(ps: [ ps.pyserial ps.fs ]))
	];		];
	}		}

Smudgebun: Moved introduction section out of Installation and to top

2026-05-05T06:52:15Z

Moved introduction section out of Installation and to top

← Older revision		Revision as of 06:52, 5 May 2026
Line 1:		Line 1:
	~~== Installation ==~~
	[https://www.blender.org/ Blender] is an open-source 3D suite for modelling, animation, VFX, and more.		[https://www.blender.org/ Blender] is an open-source 3D suite for modelling, animation, VFX, and more.

			== Installation ==
	The default <code>blender</code> nix package is compiled without support for any compute APIs (CUDA, OptiX, oneAPI, HIP), and can be installed with the following in your configuration.		The default <code>blender</code> nix package is compiled without support for any compute APIs (CUDA, OptiX, oneAPI, HIP), and can be installed with the following in your configuration.

Smudgebun: /* oneAPI */ Cleaned up issue link formatting

2026-05-04T19:35:31Z

oneAPI: Cleaned up issue link formatting

← Older revision		Revision as of 19:35, 4 May 2026
Line 180:		Line 180:

	=== oneAPI ===		=== oneAPI ===
	Currently, Nixpkgs has extremely limited oneAPI support (see: {{issue\|367722\|<nowiki>~~[Tracking] OneAPI Packages~~</nowiki>}}), which is explicitly blocking {{issue\|447245\|Blender oneAPI ~~Support~~}}. As such, the current only way to have oneAPI support on NixOS is through one of the [[#Binary Packages\|#Binary Packages]].		Currently, Nixpkgs has extremely limited oneAPI support (see {{issue\|367722\|<nowiki>the tracking issue</nowiki>}}), which is explicitly blocking {{issue\|447245\|Blender oneAPI support}}. As such, the current only way to have oneAPI support on NixOS is through one of the [[#Binary Packages\|#Binary Packages]].

	=== Last Resorts ===		=== Last Resorts ===

Smudgebun: /* Troubleshooting */ Moved Troubleshooting to Known Issues, given the content of the section

2026-05-04T17:53:42Z

Troubleshooting: Moved Troubleshooting to Known Issues, given the content of the section

← Older revision		Revision as of 17:53, 4 May 2026
Line 185:		Line 185:
	If nothing else works for your situation, you can also download the Blender binary from [https://www.blender.org/download/ blender.org] and run it in NixOS using a program like [[Nix-ld\|nix-ld]] or [https://github.com/thiagokokada/nix-alien nix-alien], patch the binary manually (see: [[Packaging/Binaries]]), or try using a container like [[Distrobox]] (see: [https://distrobox.it/useful_tips/#using-the-gpu-inside-the-container Distrobox: Using the GPU Inside the Container]).		If nothing else works for your situation, you can also download the Blender binary from [https://www.blender.org/download/ blender.org] and run it in NixOS using a program like [[Nix-ld\|nix-ld]] or [https://github.com/thiagokokada/nix-alien nix-alien], patch the binary manually (see: [[Packaging/Binaries]]), or try using a container like [[Distrobox]] (see: [https://distrobox.it/useful_tips/#using-the-gpu-inside-the-container Distrobox: Using the GPU Inside the Container]).

	== ~~Troubleshooting~~ ==		== Known Issues ==

	=== UI is dim on Vulkan backend and KDE Plasma ===		=== UI is dim on Vulkan backend and KDE Plasma ===

Smudgebun: /* Installing With Additional Python Packages */Split paragraph, added comma

2026-04-15T21:00:15Z

Installing With Additional Python Packages: Split paragraph, added comma

← Older revision		Revision as of 21:00, 15 April 2026
Line 39:		Line 39:
	In these functions, <code>ps</code> is an alias for <code>python313Packages</code>.		In these functions, <code>ps</code> is an alias for <code>python313Packages</code>.

	Installing with additional packages will result in a binary named <code>blender-wrapped</code> as it adds the python modules by wrapping Blender in a custom Python environment. When using a binary or unofficial Blender nix package, support for this feature will vary depending on if and how the packager implemented it.		Installing with additional packages will result in a binary named <code>blender-wrapped</code>, as it adds the python modules by wrapping Blender in a custom Python environment.

			When using a binary or unofficial Blender nix package, support for this feature will vary depending on if and how the packager implemented it.

	A workaround if using a package that doesn't support <code>withPackages</code> is to install the python packages globally.		A workaround if using a package that doesn't support <code>withPackages</code> is to install the python packages globally.