bootstrap/README.md

# Salt's Bootstrap Script

A script to bootstrap a user with git and some auxiliary tools.

## Building User Home

Download and run the latest `bootstrap.sh`:

```
cd
git clone https://git.desu.ltd/salt/bootstrap
./bootstrap/bootstrap.sh $HOME
```

In the event that you want to simply test `bootstrap.sh`, simply pass a different argument to it:

```
./bootstrap/bootstrap.sh -d /path/to/directory
```

See `bootstrap.sh -h` for more usage information.

## Building a Gentoo Install

First, partition out the system and build a filesystem tree in `/mnt`.

Then, download and run the latest `gentoostrap.sh`:

```
cd
git clone https://git.desu.ltd/salt/bootstrap
sudo ./bootstrap/gentoostrap.sh
```

The script supports a fair few arguments, so it's worth looking into `gentoostrap.sh -h` if you need to customize the system.

Note that this is highly specific to my environment. Most of the configuration management is done in Ansible, but this will create a user with my own personal setup.

## Older Versions

`build-home.sh` is an older version of the script kept here for legacy compatibility. Do not use it; use `bootstrap.sh`.

## Notes

* By default, the user's home directory will be bootstrapped. Passing `-d` and a different path will cause a different path to be bootstrapped.

* By default, the repository will be cloned over SSH. Either generate some keys and add them to your remote server or change the repository URI to HTTP.