summaryrefslogtreecommitdiff
path: root/docs/operation/boot-options.md
blob: 3c33ee3ec978d157b2858f11a9d57946b34b0afb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
---
lastproofread: '2025-11-14'
---

(boot-options)=

# Boot Options

:::{warning}
This function can disrupt services.
Run it only when necessary, and verify all input values before proceeding.
:::

VyOS provides several kernel command-line options to modify the normal boot
process.
To add an option, select the desired image in the GRUB menu at load time.
Type **e** to edit the first line, then type **Ctrl+X** to boot.

```{image} /_static/images/boot-options.webp
:align: center
:width: 80%
```


## Specify custom config file

You can use a configuration file instead of the default `/config/config.boot`
file. If the specified file doesn't exist or isn't readable, the system uses the
default configuration file. No additional verification is performed, so specify
a valid configuration file.

```none
vyos-config=/path/to/file
```

To load the *factory default* configuration, use:

```none
vyos-config=/opt/vyatta/etc/config.boot.default
```


## Disable specific boot process steps

These options disable certain steps in the boot process. Understand the
{ref}`boot process <boot-steps>` before using them.

:::{glossary}
no-vyos-migrate
   Do not perform config migration.

no-vyos-firewall
   Do not initialize default firewall chains, renders any firewall
   configuration unusable.
:::