Skip to content

Latest commit

 

History

History
41 lines (28 loc) · 2.16 KB

README.md

File metadata and controls

41 lines (28 loc) · 2.16 KB

os

Description

Various OS-level settings suitable for hosts used as picoCTF platform components like challenge servers or webshell toolbox servers.

Like all other roles in this collection, this currently targets contemporary Ubuntu releases only.

Package upgrades

While disabled by default, this role includes a way to programmatically upgrade installed packages (upgrade_packages: "yes"). This may be useful in situations where CI workflows are used to administrate servers.

Limited maximum journald size

This role limits the maximum size of the journald journal to less than the 4GB default cap, in order to prevent logged events such as SSH connections or the launching of Docker containers from exhausting a small root storage device at runtime.

Custom ephemeral port range

The operating system's ephemeral port range (/proc/sys/net/ipv4/ip_local_port_range) can be customized. This may be useful in order to make sure that the ephemeral port range does not conflict with application-specific port assignments, such as cmgr_port_range.

Hostname

This role can optionally set a machine's hostname via the hostname role variable.

Role Variables

Name Description Default
upgrade_packages If set to "yes", run apt-get update && apt-get upgrade when this role is run. If set to "dist", runs apt-get update && apt-get dist-upgrade instead. Be careful when running this, as packages used by other roles may be affected. Note that (unless manually disabled), Ubuntu already automatically installs essential security updates via unattended-upgrades. "no"
journald_max_size Maximum size of retained journald logs. Applies to both volatile and persistent log storage. 500M
ephemeral_port_range Custom ephemeral port range for the operating system, e.g. 49152-65535. Note that the host will restart if this value is changed, to ensure that all services read the new range. unset
hostname If specified, the machine's hostname will be set to this value. unset