]>
Commit | Line | Data |
---|---|---|
e71b5d0d | 1 | Installing Proxmox VE |
6b5fc47b | 2 | ===================== |
194d2f29 | 3 | ifndef::manvolnum[] |
5f09af76 | 4 | :pve-toplevel: |
194d2f29 DM |
5 | endif::manvolnum[] |
6 | ifdef::wiki[] | |
cb84ed18 | 7 | :title: Installation |
5f09af76 DM |
8 | endif::wiki[] |
9 | ||
2c6fed66 TM |
10 | {pve} is based on Debian, therefore the disk image (ISO file) provided |
11 | by us includes a complete Debian system ("stretch" for version 5.x) as | |
2d99ce9b DM |
12 | well as all necessary {pve} packages. |
13 | ||
2c6fed66 TM |
14 | Using the installer will guide you through the setup, allowing |
15 | you to partition the local disk(s), apply basic system configurations | |
16 | (e.g. timezone, language, network) and install all required packages. | |
17 | Using the provided ISO will get you started in just a few minutes, | |
18 | that's why we recommend this method for new and existing users. | |
d91f8c1e | 19 | |
2d99ce9b DM |
20 | Alternatively, {pve} can be installed on top of an existing Debian |
21 | system. This option is only recommended for advanced users since | |
2c6fed66 | 22 | detailed knowledge about {pve} is necessary. |
d91f8c1e | 23 | |
bc1c71d4 DM |
24 | ifndef::wiki[] |
25 | ||
26 | include::pve-system-requirements.adoc[] | |
27 | ||
28 | endif::wiki[] | |
29 | ||
5eba0743 | 30 | |
2c6fed66 TM |
31 | Using the {pve} Installer |
32 | ------------------------- | |
d91f8c1e | 33 | |
459d5f13 OB |
34 | You can download the ISO from {website}en/downloads. |
35 | It includes the following: | |
115aef16 | 36 | |
e69c1847 DM |
37 | * Complete operating system (Debian Linux, 64-bit) |
38 | ||
2c6fed66 | 39 | * The {pve} installer, which partitions the local disk(s) with ext4, |
2d99ce9b | 40 | ext3, xfs or ZFS and installs the operating system. |
e69c1847 | 41 | |
2d99ce9b | 42 | * {pve} kernel (Linux) with LXC and KVM support |
e69c1847 DM |
43 | |
44 | * Complete toolset for administering virtual machines, containers and | |
45 | all necessary resources | |
46 | ||
a1856f27 | 47 | * Web based management interface for using the toolset |
115aef16 | 48 | |
459d5f13 OB |
49 | NOTE: During the installation process, the complete server |
50 | is used by default and all existing data is removed. | |
078924cd | 51 | |
3fecf41f | 52 | Please insert the installation media (e.g. USB stick, CD-ROM) and boot |
2c6fed66 TM |
53 | from it. |
54 | ||
1ff5e4e8 | 55 | [thumbnail="screenshot/pve-grub-menu.png"] |
2d99ce9b | 56 | |
2c6fed66 TM |
57 | After choosing the correct entry (e.g. Boot from USB) the {pve} menu |
58 | will be displayed, you can now select one of the following options: | |
d91f8c1e DM |
59 | |
60 | Install Proxmox VE:: | |
61 | ||
62 | Start normal installation. | |
63 | ||
1a5554fc TL |
64 | TIP: It is possible to only use the keyboard to progress through the |
65 | installation wizard. Buttons can be pressed by pressing down the `ALT` | |
66 | key, combined with the underlined character from the respective Button. | |
00c6976d | 67 | For example, `ALT + N` to press a `Next` button. |
1a5554fc | 68 | |
d91f8c1e DM |
69 | Install Proxmox VE (Debug mode):: |
70 | ||
71 | Start installation in debug mode. It opens a shell console at several | |
72 | installation steps, so that you can debug things if something goes | |
73 | wrong. Please press `CTRL-D` to exit those debug consoles and continue | |
74 | installation. This option is mostly for developers and not meant for | |
75 | general use. | |
76 | ||
77 | Rescue Boot:: | |
78 | ||
79 | This option allows you to boot an existing installation. It searches | |
f77a3c10 | 80 | all attached hard disks and, if it finds an existing installation, |
d91f8c1e DM |
81 | boots directly into that disk using the existing Linux kernel. This |
82 | can be useful if there are problems with the boot block (grub), or the | |
83 | BIOS is unable to read the boot block from the disk. | |
84 | ||
85 | Test Memory:: | |
86 | ||
d7495642 | 87 | Runs `memtest86+`. This is useful to check if your memory is |
d91f8c1e DM |
88 | functional and error free. |
89 | ||
1ff5e4e8 | 90 | [thumbnail="screenshot/pve-select-target-disk.png"] |
2d99ce9b | 91 | |
d91f8c1e DM |
92 | You normally select *Install Proxmox VE* to start the installation. |
93 | After that you get prompted to select the target hard disk(s). The | |
8e4bb261 | 94 | `Options` button lets you select the target file system, which |
8c1189b6 FG |
95 | defaults to `ext4`. The installer uses LVM if you select `ext3`, |
96 | `ext4` or `xfs` as file system, and offers additional option to | |
d91f8c1e DM |
97 | restrict LVM space (see <<advanced_lvm_options,below>>) |
98 | ||
71280de0 SI |
99 | You can also use ZFS as file system. ZFS supports several software RAID |
100 | levels, so this is specially useful if you do not have a hardware RAID | |
101 | controller. The `Options` button lets you select the ZFS RAID level, and | |
102 | you can choose disks there. Additionally you can set additional options (see | |
103 | <<advanced_zfs_options,below>>). | |
d91f8c1e | 104 | |
1ff5e4e8 | 105 | [thumbnail="screenshot/pve-select-location.png", float="left"] |
2d99ce9b | 106 | |
a22d7c24 | 107 | The next page just asks for basic configuration options like your |
2d99ce9b | 108 | location, the time zone and keyboard layout. The location is used to |
2c6fed66 TM |
109 | select a download server near you to speed up updates. The installer is |
110 | usually able to auto detect those settings, so you only need to change | |
2d99ce9b DM |
111 | them in rare situations when auto detection fails, or when you want to |
112 | use some special keyboard layout not commonly used in your country. | |
113 | ||
1ff5e4e8 | 114 | [thumbnail="screenshot/pve-set-password.png"] |
2d99ce9b DM |
115 | |
116 | You then need to specify an email address and the superuser (root) | |
117 | password. The password must have at least 5 characters, but we highly | |
118 | recommend to use stronger passwords - here are some guidelines: | |
119 | ||
120 | - Use a minimum password length of 12 to 14 characters. | |
121 | ||
122 | - Include lowercase and uppercase alphabetic characters, numbers and symbols. | |
123 | ||
124 | - Avoid character repetition, keyboard patterns, dictionary words, | |
125 | letter or number sequences, usernames, relative or pet names, | |
126 | romantic links (current or past) and biographical information (e.g., | |
127 | ID numbers, ancestors' names or dates). | |
128 | ||
2c6fed66 | 129 | It is sometimes necessary to send notifications to the system |
2d99ce9b DM |
130 | administrator, for example: |
131 | ||
132 | - Information about available package updates. | |
133 | ||
134 | - Error messages from periodic CRON jobs. | |
135 | ||
7df6cb98 TL |
136 | [thumbnail="screenshot/pve-setup-network.png"] |
137 | ||
2d99ce9b DM |
138 | All those notification mails will be sent to the specified email |
139 | address. | |
140 | ||
d91f8c1e DM |
141 | The last step is the network configuration. Please note that you can |
142 | use either IPv4 or IPv6 here, but not both. If you want to configure a | |
143 | dual stack node, you can easily do that after installation. | |
144 | ||
1ff5e4e8 | 145 | [thumbnail="screenshot/pve-installation.png", float="left"] |
2d99ce9b | 146 | |
7df6cb98 TL |
147 | If you press `Next` now, you will see an overview of your entered |
148 | configuration. Please re-check every setting, you can still use the | |
149 | `Previous` button to go back and edit all settings here. | |
150 | ||
151 | If you press `Install` now, installation starts to format disks, and | |
d91f8c1e | 152 | copies packages to the target. Please wait until that is finished, |
2c6fed66 | 153 | then remove the installation media and restart your system. |
d91f8c1e | 154 | |
7df6cb98 TL |
155 | [thumbnail="screenshot/pve-install-summary.png"] |
156 | ||
157 | If the installation failed check out specific errors on the second TTY | |
158 | (`CTRL + ALT + F2'), ensure your systems mets the | |
159 | xref:install_minimal_requirements[minimum requirements]. If the installation | |
160 | is still not working then look at our xref:getting_help[how to get help chapter]. | |
161 | ||
162 | Further configuration can be done via the Proxmox web interface. Just | |
d91f8c1e | 163 | point your browser to the IP address given during installation |
69255fd2 | 164 | (https://youripaddress:8006). |
d91f8c1e | 165 | |
7df6cb98 | 166 | NOTE: Default login is "root" (realm 'PAM') and the root password was |
fe6c04d5 DM |
167 | defined during the installation process. |
168 | ||
d91f8c1e DM |
169 | |
170 | [[advanced_lvm_options]] | |
5eba0743 | 171 | Advanced LVM Configuration Options |
6b5fc47b | 172 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
d91f8c1e DM |
173 | |
174 | The installer creates a Volume Group (VG) called `pve`, and additional | |
175 | Logical Volumes (LVs) called `root`, `data` and `swap`. The size of | |
176 | those volumes can be controlled with: | |
177 | ||
178 | `hdsize`:: | |
179 | ||
180 | Defines the total HD size to be used. This way you can save free | |
181 | space on the HD for further partitioning (i.e. for an additional PV | |
182 | and VG on the same hard disk that can be used for LVM storage). | |
183 | ||
184 | `swapsize`:: | |
185 | ||
fa281da6 TL |
186 | Defines the size of the `swap` volume. The default is the size of the |
187 | installed memory, minimum 4 GB and maximum 8 GB. The resulting value cannot | |
188 | be greater than `hdsize/8`. | |
e8fe2b1b FG |
189 | + |
190 | NOTE: If set to `0`, no `swap` volume will be created. | |
d91f8c1e DM |
191 | |
192 | `maxroot`:: | |
193 | ||
fa281da6 TL |
194 | Defines the maximum size of the `root` volume, which stores the operation |
195 | system. The maximum limit of the `root` volume size is `hdsize/4`. | |
d91f8c1e DM |
196 | |
197 | `maxvz`:: | |
198 | ||
fa281da6 TL |
199 | Defines the maximum size of the `data` volume. The actual size of the `data` |
200 | volume is: | |
201 | + | |
202 | `datasize = hdsize - rootsize - swapsize - minfree` | |
203 | + | |
204 | Where `datasize` cannot be bigger than `maxvz`. | |
e8fe2b1b FG |
205 | + |
206 | NOTE: In case of LVM thin, the `data` pool will only be created if `datasize` | |
207 | is bigger than 4GB. | |
208 | + | |
209 | NOTE: If set to `0`, no `data` volume will be created and the storage | |
210 | configuration will be adapted accordingly. | |
d91f8c1e DM |
211 | |
212 | `minfree`:: | |
213 | ||
fa281da6 TL |
214 | Defines the amount of free space left in LVM volume group `pve`. |
215 | With more than 128GB storage available the default is 16GB, else `hdsize/8` | |
216 | will be used. | |
d91f8c1e DM |
217 | + |
218 | NOTE: LVM requires free space in the VG for snapshot creation (not | |
219 | required for lvmthin snapshots). | |
220 | ||
71280de0 SI |
221 | [[advanced_zfs_options]] |
222 | Advanced ZFS Configuration Options | |
223 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
224 | The installer creates a ZFS pool `rpool`. When selecting ZFS, no swap space is | |
225 | created by default. You can leave some unpartitioned space for swap or create | |
226 | a swap zvol after installation, though the latter can lead to problems | |
227 | (see <<zfs_swap,ZFS swap notes>>). | |
228 | ||
229 | `ashift`:: | |
230 | ||
231 | Defines the `ashift` value for the created pool. The `ashift` needs | |
232 | to be set at least to the sector-size of the underlying disks (2 to | |
233 | the power of `ashift` is the sector-size), or any disk, | |
234 | which might be put in the pool (e.g. during replacing a defective disk). | |
235 | ||
236 | `compress`:: | |
237 | ||
238 | Defines whether compression is enabled for `rpool`. | |
239 | ||
240 | `checksum`:: | |
241 | ||
242 | Defines which checksumming algorithm should be used for `rpool`. | |
243 | ||
244 | `copies`:: | |
245 | ||
246 | Defines the `copies` parameter for `rpool`. Check the `zfs(8)` manpage for the | |
247 | semantics, and why this does not replace redundancy on disk-level. | |
248 | ||
249 | `hdsize`:: | |
250 | ||
251 | Defines the total HD size to be used. This way you can save free | |
a94a57d7 | 252 | space on the HD(s) for further partitioning (e.g. for creating a swap-partition). |
947b5571 TL |
253 | `hdsize` is only honored for bootable disks, i.e., only the first disk or |
254 | mirror for RAID0, RAID1 or RAID10, and all disks in RAID-Z[123]. | |
71280de0 | 255 | |
d91f8c1e DM |
256 | |
257 | ZFS Performance Tips | |
6b5fc47b | 258 | ~~~~~~~~~~~~~~~~~~~~ |
d91f8c1e | 259 | |
cdf58596 WL |
260 | ZFS uses a lot of memory, so it is best to add additional RAM if you |
261 | want to use ZFS. A good calculation is 4GB plus 1GB RAM for each TB | |
262 | RAW disk space. | |
d91f8c1e DM |
263 | |
264 | ZFS also provides the feature to use a fast SSD drive as write cache. The | |
265 | write cache is called the ZFS Intent Log (ZIL). You can add that after | |
266 | installation using the following command: | |
267 | ||
268 | zpool add <pool-name> log </dev/path_to_fast_ssd> | |
269 | ||
078924cd DM |
270 | |
271 | ifdef::wiki[] | |
272 | ||
5c6cf7ac DM |
273 | link:/wiki/Install_from_USB_Stick[Install from USB Stick] |
274 | --------------------------------------------------------- | |
275 | ||
2c6fed66 TM |
276 | link:/wiki/Install_Proxmox_VE_on_Debian_Stretch[Install Proxmox VE on Debian Stretch] |
277 | ------------------------------------------------------------------------------------- | |
278 | ||
078924cd DM |
279 | endif::wiki[] |
280 | ||
281 | ifndef::wiki[] | |
282 | ||
2c6fed66 TM |
283 | include::pve-usbstick.adoc[] |
284 | ||
078924cd | 285 | Install {pve} on Debian |
6b5fc47b | 286 | ----------------------- |
078924cd | 287 | |
115aef16 | 288 | {pve} ships as a set of Debian packages, so you can install it |
b05a12f8 TL |
289 | on top of a standard Debian installation. |
290 | xref:sysadmin_package_repositories[After configuring the repositories], you | |
291 | need to run: | |
078924cd DM |
292 | |
293 | [source,bash] | |
294 | ---- | |
295 | apt-get update | |
296 | apt-get install proxmox-ve | |
297 | ---- | |
298 | ||
115aef16 FR |
299 | Installing on top of an existing Debian installation looks easy, but |
300 | it presumes that you have correctly installed the base system, and you | |
301 | know how you want to configure and use the local storage. Network | |
302 | configuration is also completely up to you. | |
303 | ||
304 | In general, this is not trivial, especially when you use LVM or | |
305 | ZFS. | |
306 | ||
459d5f13 | 307 | You can find a detailed step by step how-to guide on the |
acb3e8d7 | 308 | {webwiki-url}Install_Proxmox_VE_on_Debian_Stretch[wiki]. |
078924cd | 309 | |
078924cd | 310 | |
5c6cf7ac | 311 | endif::wiki[] |
078924cd | 312 | |
078924cd DM |
313 | ifdef::wiki[] |
314 | ||
315 | Video Tutorials | |
6b5fc47b | 316 | --------------- |
078924cd DM |
317 | |
318 | * List of all official tutorials on our | |
319 | http://www.youtube.com/proxmoxve[Proxmox VE YouTube Channel] | |
320 | ||
321 | * Tutorials in Spanish language on | |
322 | http://www.youtube.com/playlist?list=PLUULBIhA5QDBdNf1pcTZ5UXhek63Fij8z[ITexperts.es | |
323 | YouTube Play List] | |
324 | ||
325 | ||
326 | See Also | |
6b5fc47b | 327 | -------- |
078924cd | 328 | |
bc1c71d4 DM |
329 | * link:/wiki/System_Requirements[System Requirements] |
330 | ||
078924cd DM |
331 | * link:/wiki/Package_Repositories[Package Repositories] |
332 | ||
333 | * link:/wiki/Host_System_Administration[Host System Administration] | |
334 | ||
335 | * link:/wiki/Network_Configuration[Network Configuration] | |
336 | ||
e723066c DM |
337 | * link:/wiki/Installation:_Tips_and_Tricks[Installation: Tips and Tricks] |
338 | ||
078924cd | 339 | endif::wiki[] |