1OSBUILD-COMPOSER(7)              Miscellaneous             OSBUILD-COMPOSER(7)
2
3
4

NAME

6       osbuild-composer - OSBuild Composer Service
7

DESCRIPTION

9       The  composer project is a set of HTTP services for composing operating
10       system images. It builds on the pipeline execution  engine  of  osbuild
11       [1] and defines its own class of images that it supports building.
12
13       Multiple APIs are available to access a composer service. This includes
14       support for the lorax-composer [2]  API,  and  as  such  can  serve  as
15       drop-in replacement for lorax-composer.
16
17       You  can  control  a composer instance either directly via the provided
18       APIs, or through higher-level user-interfaces from  external  projects.
19       This,  for  instance,  includes  a Cockpit Module [3] or using the com‐
20       poser-cli [4] command-line tool.
21
22   Frontends
23       Composer does not ship with frontends itself. However, several external
24       frontends for Composer already exist. These include:
25
26       Cockpit Composer
27              This module for Cockpit [5] allows a great level of control of a
28              Composer instance running on a cockpit-managed machine.
29
30       Composer CLI
31              This command-line tool originated in the lorax [2] project,  but
32              can be used with Composer just as well.
33

RUNNING

35       To deploy a composer instance, all you need is to
36
37          # systemctl start osbuild-composer.socket
38
39
40
41       Now you can access the service using composer-cli, for example:
42
43          # composer-cli status show
44
45
46
47       or  using  Cockpit  with  the  Cockpit  Composer module from a browser:
48       http://localhost:9090
49

SEE ALSO

51       osbuild(1), osbuild-manifest(5)
52

NOTES

54       [1]  OSBuild: https://www.osbuild.org
55
56       [2]  Lorax Composer: https://github.com/weldr/lorax
57
58       [3]  Cockpit Composer: https://github.com/osbuild/cockpit-composer
59
60       [4]  Composer CLI: https://weldr.io/lorax/composer-cli.html
61
62       [5]  Cockpit Project: https://www.cockpit-project.org/
63
64
65
66
67                                                           OSBUILD-COMPOSER(7)
Impressum