system_requirements.rst 33 KB

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