system-from-scratch/README.md

41 lines
878 B
Markdown

# System from scratch
Ansible playbooks for system configuration.
This repo contains Ansible playbooks for configuring a Debian Linux system from scratch.
It handles tasks like installing packages, configuring services, users, etc.
## Getting Started
1. Clone the repo.
```bash
git clone https://git.comfycamp.space/lumin/system-from-scratch.git
```
2. Create an inventory file.
Example:
```ini
; this group name is used in all playbooks.
[odhosts]
localhost ansible_connection=local
192.0.2.0
```
3. Run a playbook.
```bash
ansible-playbook -i inventory.ini [--ask-become] ping.yml
```
## Purpose
This repository can serve as a source of inspiration.
Ansible allows you not only to initially configure the system,
but also to synchronize settings between several computers.
## Contributing
Bug fixes and improvements are welcome, please submit your pull requests.