Skip to content

Commit f9ac49e

Browse files
committed
Mention to turn off secure boot.
On my Thinkpad X260, it just refused to start. No error message was displayed. It was absolutely unclear whether my binary crashed or there was another problem. The problem was indeed secure boot. Since no error message was displayed, I think it's nice to mention this pitfall here to avoid some frustration.
1 parent 3317438 commit f9ac49e

File tree

1 file changed

+4
-0
lines changed

1 file changed

+4
-0
lines changed

book/src/tutorial/hardware.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,8 @@
11
# Running on Hardware
22

3+
Prerequisite: To allow loading your unsigned binary on your personal machine,
4+
[secure boot] needs to be disabled in the BIOS setup.
5+
36
To run on real hardware you'll need a specially-prepared USB drive.
47

58
## Preparation
@@ -67,6 +70,7 @@ key.
6770

6871
Once the one-time boot menu appears, select your USB drive and press enter.
6972

73+
[secure boot]: https://en.wikipedia.org/wiki/UEFI#Secure_Boot
7074
[GPT]: https://en.wikipedia.org/wiki/GUID_Partition_Table
7175
[FAT]: https://en.wikipedia.org/wiki/File_Allocation_Table
7276
[boot files]: ../concepts/gpt.html#system-partition

0 commit comments

Comments
 (0)