68 lines
1.4 KiB
Markdown
68 lines
1.4 KiB
Markdown
|
# Build & install
|
||
|
|
|
||
|
|
The following page explains how to build and install the shadow project.
|
||
|
|
Additional information on how to do this in a container environment is provided
|
||
|
|
at the end of the page.
|
||
|
|
|
||
|
|
## Local
|
||
|
|
|
||
|
|
### Dependency installation
|
||
|
|
|
||
|
|
This projects depends on other software packages that need to be installed
|
||
|
|
before building it. We recommend using the dependency installation commands
|
||
|
|
provided by the distributions to install them. Some examples below.
|
||
|
|
|
||
|
|
Debian:
|
||
|
|
```
|
||
|
|
apt-get build-dep shadow
|
||
|
|
```
|
||
|
|
|
||
|
|
Fedora:
|
||
|
|
```
|
||
|
|
dnf builddep shadow-utils
|
||
|
|
```
|
||
|
|
|
||
|
|
### Configure
|
||
|
|
|
||
|
|
The first step is to configure it. You can use the
|
||
|
|
`autogen.sh` script provided by the project. Example:
|
||
|
|
|
||
|
|
```
|
||
|
|
./autogen.sh --without-selinux --enable-man --with-yescrypt
|
||
|
|
```
|
||
|
|
|
||
|
|
### Build
|
||
|
|
|
||
|
|
The next step is to build the project:
|
||
|
|
|
||
|
|
```
|
||
|
|
make -j4
|
||
|
|
```
|
||
|
|
|
||
|
|
### Install
|
||
|
|
|
||
|
|
The last step is to install it. We recommend avoiding this step and using a
|
||
|
|
disposable system like a VM or a container instead.
|
||
|
|
|
||
|
|
```
|
||
|
|
make install
|
||
|
|
```
|
||
|
|
|
||
|
|
## Containers
|
||
|
|
|
||
|
|
Alternatively, you can use any of the preconfigured container images builders
|
||
|
|
to build and install shadow.
|
||
|
|
|
||
|
|
You can either generate a single image by running the following command from
|
||
|
|
the root folder of the project (i.e. Alpine):
|
||
|
|
|
||
|
|
```
|
||
|
|
docker build -f share/containers/alpine.dockerfile . --output build-out/alpine
|
||
|
|
```
|
||
|
|
|
||
|
|
Or generate all of the images with the `container-build.sh` script, as if you
|
||
|
|
were running some of the CI checks locally:
|
||
|
|
|
||
|
|
```
|
||
|
|
share/container-build.sh
|
||
|
|
```
|