hosting/mash-playbook
1
0
Fork 0
Code Pull requests Activity

Add additional swap explanations in system.md

Browse source
This commit is contained in:
Slavi Pantaleev 2023-03-18 16:02:11 +02:00 • committed by GitHub
parent 33f1875ee9
commit a5685d09a5
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 10 additions and 4 deletions

14
docs/services/system.md
View file

@ -1,11 +1,11 @@
# System-related configuration
This Ansible playbook can install and configure various system-related things for you.
All the sections below relates to the host OS instead of docker containers.
All the sections below relate to the host OS instead of the managed containers.
### swap
To enable [swap](https://en.wikipedia.org/wiki/Memory_paging) management, add the following configuration to your `vars.yml` file and re-run the [installation](../installing.md) process:
To enable [swap](https://en.wikipedia.org/wiki/Memory_paging) management (also read more in the [Swap](https://wiki.archlinux.org/title/Swap) article in the [Arch Linux Wiki](https://wiki.archlinux.org/)), add the following configuration to your `vars.yml` file and re-run the [installation](../installing.md) process:
```yaml
########################################################################
@ -23,8 +23,14 @@ system_swap_enabled: true
########################################################################
```
By default, swap file size calculated using the following formula: `total RAM * 2 if total RAM <= 2GB, else - 1GB`,
if you want to set different swap file size, you can set the `system_swap_size` var in megabytes, example (4gb):
A swap file will be created in `/var/swap` (configured using the `system_swap_path` variable) and enabled in your `/etc/fstab` file.
By default, the swap file will have the following size:
- on systems with `<= 2GB` of RAM, swap file size = `total RAM * 2`
- on systems with `> 2GB` of RAM, swap file size = `1GB`
To avoid these calculations and set your own size explicitly, set the `system_swap_size` variable in megabytes, example (4gb):
```yaml
system_swap_size: 4096