system_requirements.rst 34 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373
  1. :allow_comments: False
  2. .. _doc_system_requirements:
  3. System requirements
  4. ===================
  5. This page contains system requirements for the editor and exported projects.
  6. These specifications are given for informative purposes only, but they can be
  7. referred to if you're looking to build or upgrade a system to use Godot on.
  8. Godot editor
  9. ------------
  10. These are the **minimum** specifications required to run the Godot editor and work
  11. on a simple 2D or 3D project:
  12. Desktop or laptop PC - Minimum
  13. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  14. .. When adjusting specifications, make sure to only mention hardware that can run the required OS version.
  15. .. For example, the x86 CPU requirement for macOS is set after the MacBook Air 11" (late 2010 model),
  16. .. which can run up to macOS 10.13.
  17. +----------------------+-----------------------------------------------------------------------------------------+
  18. | **CPU** | - **Windows:** x86_32 CPU with SSE2 instructions, x86_64 CPU, ARMv8 CPU |
  19. | | |
  20. | | - *Example: Intel Core 2 Duo E8200, AMD Athlon XE BE-2300, Snapdragon X Elite* |
  21. | | |
  22. | | - **macOS:** x86_64 or ARM CPU (Apple Silicon) |
  23. | | |
  24. | | - *Example: Intel Core 2 Duo SU9400, Apple M1* |
  25. | | |
  26. | | - **Linux:** x86_32 CPU with SSE2 instructions, x86_64 CPU, ARMv7 or ARMv8 CPU |
  27. | | |
  28. | | - *Example: Intel Core 2 Duo E8200, AMD Athlon XE BE-2300, Raspberry Pi 4* |
  29. +----------------------+-----------------------------------------------------------------------------------------+
  30. | **GPU** | - **Forward+ renderer:** Integrated graphics with full Vulkan 1.0 support |
  31. | | |
  32. | | - *Example: Intel HD Graphics 5500 (Broadwell), AMD Radeon R5 Graphics (Kaveri)* |
  33. | | |
  34. | | - **Mobile renderer:** Integrated graphics with full Vulkan 1.0 support |
  35. | | |
  36. | | - *Example: Intel HD Graphics 5500 (Broadwell), AMD Radeon R5 Graphics (Kaveri)* |
  37. | | |
  38. | | - **Compatibility renderer:** Integrated graphics with full OpenGL 3.3 support |
  39. | | |
  40. | | - *Example: Intel HD Graphics 2500 (Ivy Bridge), AMD Radeon R5 Graphics (Kaveri)* |
  41. +----------------------+-----------------------------------------------------------------------------------------+
  42. | **RAM** | - **Native editor:** 4 GB |
  43. | | - **Web editor:** 8 GB |
  44. +----------------------+-----------------------------------------------------------------------------------------+
  45. | **Storage** | 200 MB (used for the executable, project files and cache). |
  46. | | Exporting projects requires downloading export templates separately |
  47. | | (1.3 GB after installation). |
  48. +----------------------+-----------------------------------------------------------------------------------------+
  49. | **Operating system** | - **Native editor:** Windows 10, macOS 10.13 (Compatibility) or |
  50. | | macOS 10.15 (Forward+/Mobile), Linux distribution released after 2018 |
  51. | | - **Web editor:** Recent versions of mainstream browsers: Firefox and derivatives |
  52. | | (including ESR), Chrome and Chromium derivatives, Safari and WebKit derivatives. |
  53. +----------------------+-----------------------------------------------------------------------------------------+
  54. .. note::
  55. Vulkan drivers for these Windows versions are known to have issues with
  56. memory leaks. As a result, it's recommended to stick to the Compatibility
  57. renderer when running Godot on a Windows version older than 10.
  58. Mobile device (smartphone/tablet) - Minimum
  59. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  60. +----------------------+-----------------------------------------------------------------------------------------+
  61. | **CPU** | - **Android:** SoC with any 32-bit or 64-bit ARM or x86 CPU |
  62. | | |
  63. | | - *Example: Qualcomm Snapdragon 430, Samsung Exynos 5 Octa 5430* |
  64. | | |
  65. | | - **iOS:** *Cannot run the editor* |
  66. +----------------------+-----------------------------------------------------------------------------------------+
  67. | **GPU** | - **Forward+ renderer:** SoC featuring GPU with full Vulkan 1.0 support |
  68. | | |
  69. | | - *Example: Qualcomm Adreno 505, Mali-G71 MP2* |
  70. | | |
  71. | | - **Mobile renderer:** SoC featuring GPU with full Vulkan 1.0 support |
  72. | | |
  73. | | - *Example: Qualcomm Adreno 505, Mali-G71 MP2* |
  74. | | |
  75. | | - **Compatibility renderer:** SoC featuring GPU with full OpenGL ES 3.0 support |
  76. | | |
  77. | | - *Example: Qualcomm Adreno 306, Mali-T628 MP6* |
  78. +----------------------+-----------------------------------------------------------------------------------------+
  79. | **RAM** | - **Native editor:** 3 GB |
  80. | | - **Web editor:** 6 GB |
  81. +----------------------+-----------------------------------------------------------------------------------------+
  82. | **Storage** | 200 MB (used for the executable, project files and cache) |
  83. | | Exporting projects requires downloading export templates separately |
  84. | | (1.3 GB after installation) |
  85. +----------------------+-----------------------------------------------------------------------------------------+
  86. | **Operating system** | - **Native editor:** Android 6.0 (Compatibility) or Android 9.0 (Forward+/Mobile) |
  87. | | - **Web editor:** Recent versions of mainstream browsers: Firefox and derivatives |
  88. | | (including ESR), Chrome and Chromium derivatives, Safari and WebKit derivatives. |
  89. +----------------------+-----------------------------------------------------------------------------------------+
  90. These are the **recommended** specifications to get a smooth experience with the
  91. Godot editor on a simple 2D or 3D project:
  92. Desktop or laptop PC - Recommended
  93. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  94. +----------------------+---------------------------------------------------------------------------------------------+
  95. | **CPU** | - **Windows:** x86_64 CPU with SSE4.2 instructions, with 4 physical cores or more, ARMv8 CPU|
  96. | | |
  97. | | - *Example: Intel Core i5-6600K, AMD Ryzen 5 1600, Snapdragon X Elite* |
  98. | | |
  99. | | - **macOS:** x86_64 or ARM CPU (Apple Silicon) |
  100. | | |
  101. | | - *Example: Intel Core i5-8500, Apple M1* |
  102. | | |
  103. | | - **Linux:** x86_32 CPU with SSE2 instructions, x86_64 CPU, ARMv7 or ARMv8 CPU |
  104. | | |
  105. | | - *Example: Intel Core i5-6600K, AMD Ryzen 5 1600, Raspberry Pi 5 with overclocking* |
  106. +----------------------+---------------------------------------------------------------------------------------------+
  107. | **GPU** | - **Forward+ renderer:** Dedicated graphics with full Vulkan 1.2 support |
  108. | | |
  109. | | - *Example: NVIDIA GeForce GTX 1050 (Pascal), AMD Radeon RX 460 (GCN 4.0)* |
  110. | | |
  111. | | - **Mobile renderer:** Dedicated graphics with full Vulkan 1.2 support |
  112. | | |
  113. | | - *Example: NVIDIA GeForce GTX 1050 (Pascal), AMD Radeon RX 460 (GCN 4.0)* |
  114. | | |
  115. | | - **Compatibility renderer:** Dedicated graphics with full OpenGL 4.6 support |
  116. | | |
  117. | | - *Example: NVIDIA GeForce GTX 650 (Kepler), AMD Radeon HD 7750 (GCN 1.0)* |
  118. +----------------------+---------------------------------------------------------------------------------------------+
  119. | **RAM** | - **Native editor:** 8 GB |
  120. | | - **Web editor:** 12 GB |
  121. +----------------------+---------------------------------------------------------------------------------------------+
  122. | **Storage** | 1.5 GB (used for the executable, project files, all export templates and cache) |
  123. +----------------------+---------------------------------------------------------------------------------------------+
  124. | **Operating system** | - **Native editor:** Windows 10, macOS 10.15, |
  125. | | Linux distribution released after 2020 |
  126. | | - **Web editor:** Latest version of Firefox, Chrome, Edge, Safari, Opera |
  127. +----------------------+---------------------------------------------------------------------------------------------+
  128. Mobile device (smartphone/tablet) - Recommended
  129. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  130. +----------------------+-----------------------------------------------------------------------------------------+
  131. | **CPU** | - **Android:** SoC with 64-bit ARM or x86 CPU, with 3 "performance" cores or more |
  132. | | |
  133. | | - *Example: Qualcomm Snapdragon 845, Samsung Exynos 9810* |
  134. | | |
  135. | | - **iOS:** *Cannot run the editor* |
  136. +----------------------+-----------------------------------------------------------------------------------------+
  137. | **GPU** | - **Forward+ renderer:** SoC featuring GPU with full Vulkan 1.2 support |
  138. | | |
  139. | | - *Example: Qualcomm Adreno 630, Mali-G72 MP18* |
  140. | | |
  141. | | - **Mobile renderer:** SoC featuring GPU with full Vulkan 1.2 support |
  142. | | |
  143. | | - *Example: Qualcomm Adreno 630, Mali-G72 MP18* |
  144. | | |
  145. | | - **Compatibility renderer:** SoC featuring GPU with full OpenGL ES 3.2 support |
  146. | | |
  147. | | - *Example: Qualcomm Adreno 630, Mali-G72 MP18* |
  148. +----------------------+-----------------------------------------------------------------------------------------+
  149. | **RAM** | - **Native editor:** 6 GB |
  150. | | - **Web editor:** 8 GB |
  151. +----------------------+-----------------------------------------------------------------------------------------+
  152. | **Storage** | 1.5 GB (used for the executable, project files, all export templates and cache) |
  153. +----------------------+-----------------------------------------------------------------------------------------+
  154. | **Operating system** | - **Native editor:** Android 9.0 |
  155. | | - **Web editor:** Latest version of Firefox, Chrome, Edge, Safari, Opera, |
  156. | | Samsung Internet |
  157. +----------------------+-----------------------------------------------------------------------------------------+
  158. Exported Godot project
  159. ----------------------
  160. .. warning::
  161. The requirements below are a baseline for a **simple** 2D or 3D project,
  162. with basic scripting and few visual flourishes. CPU, GPU, RAM and
  163. storage requirements will heavily vary depending on your project's scope,
  164. its renderer, viewport resolution and graphics settings chosen.
  165. Other programs running on the system while the project is running
  166. will also compete for resources, including RAM and video RAM.
  167. It is strongly recommended to do your own testing on low-end hardware to
  168. make sure your project runs at the desired speed. To provide scalability for
  169. low-end hardware, you will also need to introduce a
  170. `graphics options menu <https://github.com/godotengine/godot-demo-projects/tree/master/3d/graphics_settings>`__
  171. to your project.
  172. These are the **minimum** specifications required to run a simple 2D or 3D
  173. project exported with Godot:
  174. Desktop or laptop PC - Minimum
  175. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  176. .. When adjusting specifications, make sure to only mention hardware that can run the required OS version.
  177. .. For example, the x86 CPU requirement for macOS is set after the MacBook Air 11" (late 2010 model),
  178. .. which can run up to macOS 10.13.
  179. +----------------------+-----------------------------------------------------------------------------------------+
  180. | **CPU** | - **Windows:** x86_32 CPU with SSE2 instructions, any x86_64 CPU, ARMv8 CPU |
  181. | | |
  182. | | - *Example: Intel Core 2 Duo E8200, AMD Athlon XE BE-2300, Snapdragon X Elite* |
  183. | | |
  184. | | - **macOS:** x86_64 or ARM CPU (Apple Silicon) |
  185. | | |
  186. | | - *Example: Intel Core 2 Duo SU9400, Apple M1* |
  187. | | |
  188. | | - **Linux:** x86_32 CPU with SSE2 instructions, x86_64 CPU, ARMv7 or ARMv8 CPU |
  189. | | |
  190. | | - *Example: Intel Core 2 Duo E8200, AMD Athlon XE BE-2300, Raspberry Pi 4* |
  191. +----------------------+-----------------------------------------------------------------------------------------+
  192. | **GPU** | - **Forward+ renderer:** Integrated graphics with full Vulkan 1.0 support, |
  193. | | Metal 3 support (macOS) or Direct3D 12 (12_0 feature level) support (Windows) |
  194. | | |
  195. | | - *Example: Intel HD Graphics 5500 (Broadwell), AMD Radeon R5 Graphics (Kaveri)* |
  196. | | |
  197. | | - **Mobile renderer:** Integrated graphics with full Vulkan 1.0 support, |
  198. | | Metal 3 support (macOS) or Direct3D 12 (12_0 feature level) support (Windows) |
  199. | | |
  200. | | - *Example: Intel HD Graphics 5500 (Broadwell), AMD Radeon R5 Graphics (Kaveri)* |
  201. | | |
  202. | | - **Compatibility renderer:** Integrated graphics with full OpenGL 3.3 support |
  203. | | or Direct3D 11 support (Windows). |
  204. | | |
  205. | | - *Example: Intel HD Graphics 2500 (Ivy Bridge), AMD Radeon R5 Graphics (Kaveri)* |
  206. +----------------------+-----------------------------------------------------------------------------------------+
  207. | **RAM** | - **For native exports:** 2 GB |
  208. | | - **For web exports:** 4 GB |
  209. +----------------------+-----------------------------------------------------------------------------------------+
  210. | **Storage** | 150 MB (used for the executable, project files and cache) |
  211. +----------------------+-----------------------------------------------------------------------------------------+
  212. | **Operating system** | - **For native exports:** Windows 10, macOS 10.13 (Compatibility), macOS 10.15 |
  213. | | (Forward+/Mobile, Vulkan), macOS 13.0 (Forward+/Mobile, Metal), Linux distribution |
  214. | | released after 2018 |
  215. | | - **Web editor:** Recent versions of mainstream browsers: Firefox and derivatives |
  216. | | (including ESR), Chrome and Chromium derivatives, Safari and WebKit derivatives. |
  217. +----------------------+-----------------------------------------------------------------------------------------+
  218. .. note::
  219. Vulkan drivers for these Windows versions are known to have issues with
  220. memory leaks. As a result, it's recommended to stick to the Compatibility
  221. renderer when running Godot on a Windows version older than 10.
  222. Mobile device (smartphone/tablet) - Minimum
  223. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  224. +----------------------+-----------------------------------------------------------------------------------------+
  225. | **CPU** | - **Android:** SoC with any 32-bit or 64-bit ARM or x86 CPU |
  226. | | |
  227. | | - *Example: Qualcomm Snapdragon 430, Samsung Exynos 5 Octa 5430* |
  228. | | |
  229. | | - **iOS:** SoC with any 64-bit ARM CPU |
  230. | | |
  231. | | - *Example: Apple A7 (iPhone 5S)* |
  232. +----------------------+-----------------------------------------------------------------------------------------+
  233. | **GPU** | - **Forward+ renderer:** SoC featuring GPU with full Vulkan 1.0 support, or |
  234. | | Metal 3 support (iOS/iPadOS) |
  235. | | |
  236. | | - *Example (Vulkan): Qualcomm Adreno 505, Mali-G71 MP2, Apple A12 (iPhone XR/XS)* |
  237. | | - *Example (Metal): Apple A11 (iPhone 8/X)* |
  238. | | |
  239. | | - **Mobile renderer:** SoC featuring GPU with full Vulkan 1.0 support, or |
  240. | | Metal 3 support (iOS/iPadOS) |
  241. | | |
  242. | | - *Example (Vulkan): Qualcomm Adreno 505, Mali-G71 MP2, Apple A12 (iPhone XR/XS)* |
  243. | | - *Example (Metal): Apple A11 (iPhone 8/X)* |
  244. | | |
  245. | | - **Compatibility renderer:** SoC featuring GPU with full OpenGL ES 3.0 support |
  246. | | |
  247. | | - *Example: Qualcomm Adreno 306, Mali-T628 MP6, Apple A7 (iPhone 5S)* |
  248. +----------------------+-----------------------------------------------------------------------------------------+
  249. | **RAM** | - **For native exports:** 1 GB |
  250. | | - **For web exports:** 2 GB |
  251. +----------------------+-----------------------------------------------------------------------------------------+
  252. | **Storage** | 150 MB (used for the executable, project files and cache) |
  253. +----------------------+-----------------------------------------------------------------------------------------+
  254. | **Operating system** | - **For native exports:** Android 6.0 (Compatibility), Android 9.0 (Forward+/Mobile), |
  255. | | iOS 12.0 (Forward+/Mobile, Vulkan), iOS 16.0 (Forward+/Mobile, Metal) |
  256. | | - **Web editor:** Recent versions of mainstream browsers: Firefox and derivatives |
  257. | | (including ESR), Chrome and Chromium derivatives, Safari and WebKit derivatives. |
  258. +----------------------+-----------------------------------------------------------------------------------------+
  259. These are the **recommended** specifications to get a smooth experience with a
  260. simple 2D or 3D project exported with Godot:
  261. Desktop or laptop PC - Recommended
  262. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  263. +----------------------+----------------------------------------------------------------------------------------------+
  264. | **CPU** | - **Windows:** x86_64 CPU with SSE4.2 instructions, with 4 physical cores or more, ARMv8 CPU |
  265. | | |
  266. | | - *Example: Intel Core i5-6600K, AMD Ryzen 5 1600, Snapdragon X Elite* |
  267. | | |
  268. | | - **macOS:** x86_64 or ARM CPU (Apple Silicon) |
  269. | | |
  270. | | - *Example: Intel Core i5-8500, Apple M1* |
  271. | | |
  272. | | - **Linux:** x86_32 CPU with SSE2 instructions, x86_64 CPU, ARMv7 or ARMv8 CPU |
  273. | | |
  274. | | - *Example: Intel Core i5-6600K, AMD Ryzen 5 1600, Raspberry Pi 5 with overclocking* |
  275. +----------------------+----------------------------------------------------------------------------------------------+
  276. | **GPU** | - **Forward+ renderer:** Dedicated graphics with full Vulkan 1.2 support, |
  277. | | Metal 3 support (macOS), or Direct3D 12 (12_0 feature level) support (Windows) |
  278. | | |
  279. | | - *Example: NVIDIA GeForce GTX 1050 (Pascal), AMD Radeon RX 460 (GCN 4.0)* |
  280. | | |
  281. | | - **Mobile renderer:** Dedicated graphics with full Vulkan 1.2 support, |
  282. | | Metal 3 support (macOS), or Direct3D 12 (12_0 feature level) support (Windows) |
  283. | | |
  284. | | - *Example: NVIDIA GeForce GTX 1050 (Pascal), AMD Radeon RX 460 (GCN 4.0)* |
  285. | | |
  286. | | - **Compatibility renderer:** Dedicated graphics with full OpenGL 4.6 support |
  287. | | |
  288. | | - *Example: NVIDIA GeForce GTX 650 (Kepler), AMD Radeon HD 7750 (GCN 1.0)* |
  289. +----------------------+----------------------------------------------------------------------------------------------+
  290. | **RAM** | - **For native exports:** 4 GB |
  291. | | - **For web exports:** 8 GB |
  292. +----------------------+----------------------------------------------------------------------------------------------+
  293. | **Storage** | 150 MB (used for the executable, project files and cache) |
  294. +----------------------+----------------------------------------------------------------------------------------------+
  295. | **Operating system** | - **For native exports:** Windows 10, macOS 10.15 (Forward+/Mobile, Vulkan), macOS 13.0 |
  296. | | (Forward+/Mobile, Metal), Linux distribution released after 2020 |
  297. | | - **For web exports:** Latest version of Firefox, Chrome, Edge, Safari, Opera |
  298. +----------------------+----------------------------------------------------------------------------------------------+
  299. Mobile device (smartphone/tablet) - Recommended
  300. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  301. +----------------------+-----------------------------------------------------------------------------------------+
  302. | **CPU** | - **Android:** SoC with 64-bit ARM or x86 CPU, with 3 "performance" cores or more |
  303. | | |
  304. | | - *Example: Qualcomm Snapdragon 845, Samsung Exynos 9810* |
  305. | | |
  306. | | - **iOS:** SoC with 64-bit ARM CPU |
  307. | | |
  308. | | - *Example: Apple A14 (iPhone 12)* |
  309. +----------------------+-----------------------------------------------------------------------------------------+
  310. | **GPU** | - **Forward+ renderer:** SoC featuring GPU with full Vulkan 1.2 support, or |
  311. | | Metal 3 support (iOS/iPadOS) |
  312. | | |
  313. | | - *Example: Qualcomm Adreno 630, Mali-G72 MP18, Apple A14 (iPhone 12)* |
  314. | | |
  315. | | - **Mobile renderer:** SoC featuring GPU with full Vulkan 1.2 support, or |
  316. | | Metal 3 support (iOS/iPadOS) |
  317. | | |
  318. | | - *Example: Qualcomm Adreno 630, Mali-G72 MP18, Apple A14 (iPhone 12)* |
  319. | | |
  320. | | - **Compatibility renderer:** SoC featuring GPU with full OpenGL ES 3.2 support |
  321. | | |
  322. | | - *Example: Qualcomm Adreno 630, Mali-G72 MP18, Apple A14 (iPhone 12)* |
  323. +----------------------+-----------------------------------------------------------------------------------------+
  324. | **RAM** | - **For native exports:** 2 GB |
  325. | | - **For web exports:** 4 GB |
  326. +----------------------+-----------------------------------------------------------------------------------------+
  327. | **Storage** | 150 MB (used for the executable, project files and cache) |
  328. +----------------------+-----------------------------------------------------------------------------------------+
  329. | **Operating system** | - **For native exports:** Android 9.0, iOS 14.1 (Forward+/Mobile, Vulkan), iOS 16.0 |
  330. | | (Forward+/Mobile, Metal) |
  331. | | - **For web exports:** Latest version of Firefox, Chrome, Edge, Safari, Opera, |
  332. | | Samsung Internet |
  333. +----------------------+-----------------------------------------------------------------------------------------+
  334. .. note::
  335. Godot doesn't use OpenGL/OpenGL ES extensions introduced after OpenGL
  336. 3.3/OpenGL ES 3.0, but GPUs supporting newer OpenGL/OpenGL ES versions
  337. generally have fewer driver issues.