@@ -12,24 +12,36 @@ bring in all the needed dependencies.
12
12
13
13
## Build information
14
14
15
- ### Build flags
15
+ balenaOS currently only builds with cgroups v1. If your distribution defaults
16
+ to using cgroups v2, please boot with the following kernel command line
17
+ argument:
18
+ ` systemd.unified_cgroup_hierarchy=0 `
16
19
17
- * Consult layers/meta-balena/README.md for info on various build flags (setting
18
- up serial console support for example) and build prerequisites. Build flags can
19
- be set by using the build script (barys) or by manually modifying ` local.conf ` .
20
+ ### Containerized build
21
+
22
+ * If you have a working docker installation, you can build in a containerized
23
+ environment as follows:
24
+ ` ./balena-yocto-scripts/build/balena-build.sh -d <device type> -s <shared directory> `
25
+
26
+ Where:
27
+ * Device type is one of the supported devices with a valid ` <device type name>.coffee ` description file.
28
+ * Shared directory is the absolute path to the build folder
29
+
30
+ ### Native build
20
31
21
- See below for using the build script.
32
+ To build all supported device types natively, please make sure your Linux
33
+ distribution is [ supported] ( https://docs.yoctoproject.org/singleindex.html#supported-linux-distributions ) by Yocto Project.
22
34
23
- ### Build this repository
35
+ Additional host tools need to be installed for native builds to work.
24
36
25
- * Run the build script:
37
+ * Run the barys build script:
26
38
` ./balena-yocto-scripts/build/barys `
27
39
28
40
* You can also run barys with the -h switch to inspect the available options
29
41
30
42
### Custom build using this repository
31
43
32
- * Run the build script in dry run mode to setup an empty ` build ` directory
44
+ * Run the barys build script in dry run mode to setup an empty ` build ` directory
33
45
` ./balena-yocto-scripts/build/barys --remove-build --dry-run `
34
46
35
47
* Edit the ` local.conf ` in the ` build/conf ` directory
@@ -39,6 +51,13 @@ See below for using the build script.
39
51
40
52
* Run bitbake (see message outputted when you sourced above for examples)
41
53
54
+ ### Build flags
55
+
56
+ * Consult layers/meta-balena/README.md for info on various build flags (setting
57
+ up serial console support for example) and build prerequisites. Build flags can
58
+ be set by using the build scripts (barys or balena-build) or by manually
59
+ modifying ` local.conf ` .
60
+
42
61
## Contributing
43
62
44
63
### Issues
0 commit comments