CentOS Stream 10 LVM on AWS User Guide
Overview
This guide covers launching and verifying the CentOS Stream 10 LVM AMI from cloudimg on Amazon EC2. It is one version of the cloudimg CentOS Stream listing on AWS Marketplace; you pick it as the software version when you subscribe and launch. Every release and variant in the listing is described at /guides/centos-stream-aws/.
CentOS Stream 10 is the free, community-built enterprise Linux distribution maintained by the CentOS Project. It is developed just ahead of Red Hat Enterprise Linux 10: it carries the fixes and features of the next RHEL 10 minor release before RHEL ships them, as a continuous stream of updates rather than numbered point releases. This image starts from the official CentOS Stream 10 image for EC2 and adds four things:
- A hardened LVM disk layout. The root filesystem and six benchmark mount points are separate XFS logical volumes in the volume group
cs:/home,/tmp,/var,/var/tmp,/var/logand/var/log/audit. Each is mountednodev,nosuid, and/tmp,/var/tmp,/var/logand/var/log/auditare alsonoexec. A full log or temp volume cannot fill the root filesystem, and you can grow any volume on its own (Step 12). - CIS Level 1 Server remediation. The image is remediated with the OpenSCAP CIS Level 1 Server profile from SCAP Security Guide 0.1.82 (the CentOS Project's own signed
scap-security-guidepackage and its CentOS Stream 10 content), then rebooted and evaluated. Because the partitions are real, the benchmark's partition and mount option rules are applied and scored rather than waived. 301 of 303 scored rules pass (99.3%), the same on the build and on a freshly launched instance. Six rules are waived because they cannot work on an EC2 image, each with its reason. The HTML report, the machine-readable results, the waiver list and a summary ship in/usr/share/doc/cloudimg/. - EC2 defaults that keep you in control. Key-only SSH as
ec2-user, root locked, no password on any account, SELinux enforcing, IMDSv2 required, a host firewall (firewalld) that allows SSH in and everything out, the current AWS Systems Manager agent, and time from the Amazon Time Sync Service. - Fully patched at build time, with
dnf-automaticapplying all available updates on your instance every day. CentOS Stream publishes no separate security advisories, so there is no "security only" update set to choose; every update is applied.
What is on the image: CentOS Stream 10 (the 6.12 kernel), LVM2, cloud-init, OpenSSH, firewalld, chrony, SELinux (targeted policy, enforcing), the AWS Systems Manager agent, auditd, rsyslog, AIDE file integrity checking, dnf-automatic, OpenSCAP and the pinned SCAP Security Guide content used for the evaluation.
Default user: ec2-user · Architecture: x86_64 · Boot mode: legacy BIOS · Root volume: 12 GiB gp3, one LVM physical volume holding seven XFS logical volumes
These images are remediated with an OpenSCAP profile and ship their own evaluation report. They are not CIS Hardened Images, and CIS has not reviewed or certified them. CIS publishes no benchmark for CentOS Stream; the profile is the Red Hat Enterprise Linux 10 CIS content as packaged by the CentOS Project for CentOS Stream 10.
Connecting to your instance
| Version | SSH user | Root device |
|---|---|---|
| CentOS Stream 10 LVM | ec2-user |
/dev/xvda (12 GiB gp3) |
Security posture
- No known credential. There is no default password and no baked in SSH key. The only key that works is the EC2 key pair you choose at launch, which cloud-init installs for
ec2-useron first boot. - Key-only SSH.
PasswordAuthentication no,PermitRootLogin no, keyboard-interactive off, X11 forwarding off. The root account has no password and is locked. EC2 Instance Connect, which adds a second way to push SSH keys, is not installed. - Per-instance identity. SSH host keys and the machine ID are generated fresh on every instance, so no two instances share a host key.
- IMDSv2 required. The AMI is registered with
ImdsSupport v2.0, so instances launched from it refuse token-less (IMDSv1) metadata requests by default. - SELinux enforcing with the targeted policy, as CentOS Stream ships it.
- Separate, restricted volumes. Temporary and log directories cannot hold device files, set-user-ID programs or executables, and filling one of them does not fill the root filesystem.
- Host firewall. firewalld's
publiczone allows only SSH and the DHCPv6 client inbound and allows all outbound traffic, so the SSM agent, metadata service, DNS, time and package updates keep working. - Only SSH listens on the network. Nothing else on the image listens on any address.
Prerequisites
- An AWS account and permission to launch EC2 instances
- An EC2 key pair in the Region you launch in
- A security group that allows TCP 22 from your own address (not from the whole internet)
Recommended instance type: m5.large. The image runs on any current x86_64 instance type. Like every CentOS Stream 10 build for x86_64, it needs a processor with the x86-64-v3 feature level (AVX2), which current-generation EC2 x86 instance types provide.
Step 1: Launch the instance
Option A: AWS Marketplace console
- Open the cloudimg CentOS Stream listing on AWS Marketplace and choose View purchase options, then Subscribe. One subscription covers every version in the listing.
- Once the subscription is active, choose Launch your software.
- Choose One-click launch from AWS Marketplace (or Launch from EC2 Console for full control), then in Version choose CentOS Stream 10 LVM - YYYY-MM-DD (the date is when the version was added) and your Region.
- Instance type:
m5.largeis recommended; any current x86_64 type works. The software charge is $0.04 per vCPU per hour. - Key pair: choose your EC2 key pair. It is the only way in. RSA and ED25519 keys both work.
- Security group: allow inbound TCP 22 from your own IP address or network only.
- Storage: the root volume is 12 GiB gp3 by default. You can choose a larger size; the extra space stays unallocated in the LVM physical volume until you give it to the volumes you choose (Step 12).
- Metadata: leave the defaults. The image already requires IMDSv2. Then choose Launch.
Option B: AWS CLI
Run this on your own workstation. Replace the AMI ID with the one shown for your Region on the Marketplace launch page, and the key pair, security group and subnet with your own. The root device of this AMI is /dev/xvda:
aws ec2 run-instances \
--image-id ami-0123456789abcdef0 \
--instance-type m5.large \
--key-name my-key-pair \
--security-group-ids sg-0123456789abcdef0 \
--subnet-id subnet-0123456789abcdef0 \
--block-device-mappings 'DeviceName=/dev/xvda,Ebs={VolumeSize=20,VolumeType=gp3}' \
--tag-specifications 'ResourceType=instance,Tags=[{Key=Name,Value=centos-stream-10-lvm}]'
You do not need --metadata-options: the AMI already makes IMDSv2 required.
Step 2: Connect via SSH
From your workstation, connect as ec2-user with the key pair you chose:
ssh -i ~/.ssh/my-key-pair.pem ec2-user@<public-ip>
There is no password to enter. If SSH asks for one, or says Too many authentication failures, see Troubleshooting below.
You can also connect without opening port 22 at all through AWS Systems Manager Session Manager, if the instance has an instance profile that allows Systems Manager. The agent is installed and running on this image.
Step 3: Confirm the release
cat /etc/centos-release
grep -E '^(NAME|VERSION|ID|VERSION_ID|PLATFORM_ID|PRETTY_NAME)=' /etc/os-release
uname -srm
Expected output:
CentOS Stream release 10 (Coughlan)
NAME="CentOS Stream"
VERSION="10 (Coughlan)"
ID="centos"
VERSION_ID="10"
PLATFORM_ID="platform:el10"
PRETTY_NAME="CentOS Stream 10 (Coughlan)"
Linux 6.12.0-277.el10.x86_64 x86_64
CentOS Stream has no point releases: the release is just 10, and the system moves forward through ordinary dnf updates. Your kernel version will be newer if updates have installed since this image was built.
Step 4: See the LVM layout
The disk and its volumes:
lsblk -o NAME,SIZE,TYPE,FSTYPE,MOUNTPOINTS /dev/nvme0n1
Expected output with the default 12 GiB root volume:
NAME SIZE TYPE FSTYPE MOUNTPOINTS
nvme0n1 12G disk
├─nvme0n1p1 1M part
├─nvme0n1p2 200M part vfat /boot/efi
├─nvme0n1p3 1G part xfs /boot
└─nvme0n1p4 10.8G part LVM2_member
├─cs-root 4G lvm xfs /
├─cs-home 1G lvm xfs /home
├─cs-tmp 1G lvm xfs /tmp
├─cs-var 1.5G lvm xfs /var
├─cs-var_tmp 512M lvm xfs /var/tmp
├─cs-var_log 1G lvm xfs /var/log
└─cs-var_log_audit 1G lvm xfs /var/log/audit
The volume group, its logical volumes and the mount options each volume carries:
sudo vgs
sudo lvs -o lv_name,lv_size,lv_path cs
for m in / /home /tmp /var /var/tmp /var/log /var/log/audit /boot /dev/shm; do printf '%-15s %-36s %s\n' "$m" "$(findmnt -no SOURCE "$m")" "$(findmnt -no OPTIONS "$m" | tr , '\n' | grep -xE 'rw|ro|nodev|nosuid|noexec' | paste -sd, -)"; done
Expected output:
VG #PV #LV #SN Attr VSize VFree
cs 1 7 0 wz--n-- 10.80g 820.00m
LV LSize Path
home 1.00g /dev/cs/home
root 4.00g /dev/cs/root
tmp 1.00g /dev/cs/tmp
var 1.50g /dev/cs/var
var_log 1.00g /dev/cs/var_log
var_log_audit 1.00g /dev/cs/var_log_audit
var_tmp 512.00m /dev/cs/var_tmp
/ /dev/mapper/cs-root rw
/home /dev/mapper/cs-home rw,nosuid,nodev
/tmp /dev/mapper/cs-tmp rw,nosuid,nodev,noexec
/var /dev/mapper/cs-var rw,nosuid,nodev
/var/tmp /dev/mapper/cs-var_tmp rw,nosuid,nodev,noexec
/var/log /dev/mapper/cs-var_log rw,nosuid,nodev,noexec
/var/log/audit /dev/mapper/cs-var_log_audit rw,nosuid,nodev,noexec
/boot /dev/nvme0n1p3 rw,nosuid,nodev
/dev/shm tmpfs rw,nosuid,nodev,noexec

- The disk has a 1 MiB BIOS boot partition, a 200 MiB EFI system partition, a 1 GiB
/boot(XFS) and one LVM physical volume. The AMI boots in legacy BIOS mode; the EFI partition is carried but not used to boot. - The mount options are set in
/etc/fstabby filesystem UUID, so they survive reboots and apply on every instance launched from the image. The last column shows the options that matter for the benchmark;findmntlists the rest. - The volume group keeps 820 MiB free at the default size, so you can grow the volume that fills first without touching EBS (Step 12).
The kernel finds its root filesystem on the logical volume, and the same arguments are recorded in /etc/kernel/cmdline, so every kernel that a future update installs boots from the logical volume too:
grep -o 'root=[^ ]*\|rd.lvm[^ ]*' /proc/cmdline
grep -o 'root=[^ ]*\|rd.lvm[^ ]*' /etc/kernel/cmdline
rpm -q lvm2 cloud-utils-growpart xfsprogs
Expected output:
root=/dev/mapper/cs-root
rd.lvm.lv=cs/root
root=/dev/mapper/cs-root
rd.lvm.lv=cs/root
lvm2-2.03.43-1.el10.x86_64
cloud-utils-growpart-0.33-11.el10.noarch
xfsprogs-6.16.0-1.el10.x86_64
Step 5: Read the compliance evidence
The evaluation the build ran after its reboot ships on the image:
ls -lh /usr/share/doc/cloudimg/
python3 -c "import json; s=json.load(open('/usr/share/doc/cloudimg/cis-l1-summary.json')); print('profile: ', s['profileLabel'], '(SCAP Security Guide', s['ssgVersion'] + ')'); print('scored rules: ', s['scored'], ' pass:', s['pass'], ' fail:', s['fail'], ' rate:', str(s['ratePct']) + '%'); print('waived: ', s['waived'], ' not applicable:', s['notapplicable']); print('evaluated at: ', s['evaluatedAt'])"
Expected output:
total 32M
-rw-r--r--. 1 root root 29M Oct 21 11:51 cis-l1-arf.xml
-rw-r--r--. 1 root root 2.5M Oct 21 11:51 cis-l1-report.html
-rw-r--r--. 1 root root 1.3K Oct 21 11:51 cis-l1-summary.json
-rw-r--r--. 1 root root 1.7K Oct 21 11:51 cis-l1-tailoring.xml
-rw-r--r--. 1 root root 2.6K Oct 21 11:51 cis-l1-waivers.txt
-rw-r--r--. 1 root root 1.6K Oct 21 11:48 scap-security-guide-LICENSE.txt
profile: CIS Level 1 Server (SCAP Security Guide 0.1.82)
scored rules: 303 pass: 301 fail: 2 rate: 99.3%
waived: 6 not applicable: 15
evaluated at: 2026-10-21T11:51:57Z

cis-l1-report.htmlis the full OpenSCAP report, rule by rule. Copy it to your workstation and open it in a browser.cis-l1-arf.xmlis the same evaluation in the machine-readable ARF format, for compliance tooling.cis-l1-tailoring.xmlis the exact tailoring used, so you can re-run the same evaluation (Step 6).- The pass rate is pass / (pass + fail + error + unknown). Rules that are not applicable to this machine, not selected, or waived are not counted.
- Compared with the single-volume versions of this listing, the partition rules (
/tmp,/var,/var/tmp,/var/log,/var/log/auditand/homeon their own partitions, and their mount options) are scored here and pass.
To copy the report to your workstation, run this on the workstation:
scp -i ~/.ssh/my-key-pair.pem ec2-user@<public-ip>:/usr/share/doc/cloudimg/cis-l1-report.html .
The six waived rules
grep -v '^#' /usr/share/doc/cloudimg/cis-l1-waivers.txt | cut -f1,2
Expected output:
grub2_password [serial-console-and-boot]
ensure_root_password_configured [serial-console-and-boot]
accounts_maximum_age_login_defs [key-only-account-aging]
account_disable_post_pw_expiration [key-only-account-aging]
sshd_limit_user_access [ssh-access-list]
service_systemd-journal-upload_enabled [log-remote-destination]
The full reason for each is the third column of the same file. In short:
- Boot loader and root passwords: a GRUB or root password would have to be baked into the image, giving every instance the same secret. Root stays locked with no password. Set your own if you need serial console access (see Step 11).
- Password ageing defaults: the accounts cloud-init creates are key-only. An ageing limit would expire them and lock the SSH key out. Accounts that do have a password are still aged.
- SSH AllowUsers/AllowGroups: a list fixed at build time would refuse accounts you create later. Your security group restricts who can reach port 22.
- Journal upload to a remote log server: the profile switches on
systemd-journal-uploadbut sets no destination, and an image cannot know your log server. With no destination the service fails at every boot.systemd-journal-remoteis installed and the upload service is left off: create/etc/systemd/journal-upload.confwith an[Upload]section andURL=for your collector (the packaged defaults are in/usr/lib/systemd/journal-upload.conf), then runsudo systemctl enable --now systemd-journal-upload.
The two rules that do not pass
python3 -c "import json; [print(r) for r in json.load(open('/usr/share/doc/cloudimg/cis-l1-summary.json'))['failingRules']]"
Expected output:
ensure_journald_and_rsyslog_not_active_together
ensure_redhat_gpgkey_installed
- journald and rsyslog together. The benchmark wants one logging system, not both. CentOS Stream runs journald and rsyslog together by default: journald keeps the structured system journal (persistent, in
/var/log/journal), and rsyslog writes the traditional text logs (/var/log/messages,/var/log/secure,/var/log/cron) that many log shippers and audit procedures read. The image keeps both so neither kind of tooling loses its logs. If you standardise on one, for example the journal only, runsudo systemctl disable --now rsyslogon your instance and re-run Step 6. - Red Hat's package signing key. The rule comes from the RHEL content and checks that Red Hat's own release key is in the RPM database. CentOS Stream packages are signed by the CentOS Project, not by Red Hat, so that key is neither shipped nor useful here. The CentOS Official Signing Key is installed, and every repository checks package signatures (
gpgcheck=1);rpm -qa gpg-pubkeylists the keys. The image deliberately does not import a key that signs none of its packages.
Step 6: Re-run the evaluation yourself
You can repeat the evaluation at any time with the same content and tailoring. It takes about a minute:
sudo oscap xccdf eval \
--tailoring-file /usr/share/doc/cloudimg/cis-l1-tailoring.xml \
--profile xccdf_co.cloudimg_profile_cis-l1_ec2_lvm \
--results /tmp/cis-check-results.xml --report /tmp/cis-check-report.html \
/usr/share/xml/scap/ssg/content/ssg-cs10-ds.xml > /tmp/cis-check.log 2>&1
echo "oscap exit code: $? (2 = at least one rule did not pass)"
sudo python3 -c "import re,collections; c=collections.Counter(re.findall(r'<result>(\w+)</result>', open('/tmp/cis-check-results.xml').read())); s=sum(c[k] for k in ('pass','fail','error','unknown')); print(dict(sorted(c.items()))); print('pass rate: %.1f%%' % (100.0*c['pass']/s))"
Expected output:
oscap exit code: 2 (2 = at least one rule did not pass)
{'fail': 2, 'notapplicable': 15, 'notselected': 755, 'pass': 301}
pass rate: 99.3%
Your own report is at /tmp/cis-check-report.html. Use the ssg-cs10-ds.xml content shown above: the scap-security-guide package also ships ssg-rhel10-ds.xml, but that content only applies to Red Hat Enterprise Linux, so on CentOS Stream it reports almost every rule as not applicable. /tmp is noexec, which does not affect oscap: it runs its check scripts through their interpreter. As you install software and change settings, re-run this to see how your changes affect the result.
Step 7: Confirm IMDSv2 is required
curl -s -o /dev/null -w 'IMDSv1 request without a token: HTTP %{http_code}\n' http://169.254.169.254/latest/meta-data/instance-id
TOKEN=$(curl -s -X PUT -H 'X-aws-ec2-metadata-token-ttl-seconds: 60' http://169.254.169.254/latest/api/token)
curl -s -H "X-aws-ec2-metadata-token: $TOKEN" -w '\n' http://169.254.169.254/latest/meta-data/placement/region
Expected output (your Region may differ):
IMDSv1 request without a token: HTTP 401
us-east-1
A request without a session token is refused with HTTP 401, and the same request with a token works. Scripts and SDKs on the instance must use IMDSv2; every current AWS SDK and the AWS CLI do this automatically.
Step 8: The host firewall and listening ports
sudo firewall-cmd --state
sudo firewall-cmd --list-all
sudo ss -tlnp
Expected output (the interface name and process IDs may differ):
running
public (default, active)
target: default
ingress-priority: 0
egress-priority: 0
icmp-block-inversion: no
interfaces: ens5
sources:
services: dhcpv6-client ssh
ports:
protocols:
forward: yes
masquerade: no
forward-ports:
source-ports:
icmp-blocks:
rich rules:
State Recv-Q Send-Q Local Address:Port Peer Address:PortProcess
LISTEN 0 128 0.0.0.0:22 0.0.0.0:* users:(("sshd",pid=1373,fd=7))
LISTEN 0 128 [::]:22 [::]:* users:(("sshd",pid=1373,fd=8))

- Only
sshdlistens, on port 22. Nothing else on the image opens a TCP port. - The
publiczone allowssshanddhcpv6-client(replies to the instance's IPv6 DHCP client, which is how an instance in an IPv6-enabled subnet gets its address). The CentOS defaultcockpitservice is removed from the zone; Cockpit is not installed. - The loopback interface sits in firewalld's
trustedzone, with rules that drop traffic claiming a loopback source from anywhere else (a CIS requirement).
Opening a port for your own service takes two steps: allow it in the instance's security group, and allow it in firewalld. For example, for a web server on 443, run on the instance:
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload
If a port is open in the security group but not in firewalld (or the other way round), the traffic will not arrive.
Step 9: Time sync and the Systems Manager agent
systemctl is-active chronyd amazon-ssm-agent
chronyc -n sources
Expected output (the timings vary):
active
active
MS Name/IP address Stratum Poll Reach LastRx Last sample
===============================================================================
^* 169.254.169.123 3 4 77 8 +2347ns[+8461ns] +/- 454us
The ^* marks the source chrony is using: 169.254.169.123, the Amazon Time Sync Service. It is reachable from every instance without internet access, so time stays correct in a private subnet too.
The AWS Systems Manager agent is installed from Amazon's own package at its current release (3.3.5390.0 on this build). It is not in the CentOS Stream repositories, so dnf does not update it; Systems Manager can keep it current for you (the AWS-UpdateSSMAgent document, or the Auto update SSM Agent setting in Fleet Manager).
Step 10: Patch level and automatic updates
The image is fully patched at build time. Check what is pending now and how automatic updates are set up:
sudo dnf -q check-update --refresh
echo "dnf check-update exit code: $? (0 = nothing to update, 100 = updates available)"
grep -E '^(upgrade_type|apply_updates|reboot) =' /etc/dnf/automatic.conf
systemctl is-enabled dnf-automatic.timer
systemctl cat dnf-automatic.timer | grep -E '^(OnCalendar|RandomizedDelaySec)'
uname -r
Expected output on an instance launched soon after the image was built (later launches list the updates released since, with exit code 100):
dnf check-update exit code: 0 (0 = nothing to update, 100 = updates available)
upgrade_type = default
apply_updates = yes
reboot = never
enabled
OnCalendar=*-*-* 6:00
RandomizedDelaySec=60m
6.12.0-277.el10.x86_64
How dnf-automatic is configured on this image:
upgrade_type = defaultinstalls every available update, not only security fixes. CentOS Stream's repositories carry no security advisory data, so a security-only setting would install nothing at all.apply_updates = yesinstalls the updates, not just downloads them.- The timer runs daily at 06:00 (instance time, UTC by default) with a random delay of up to an hour.
reboot = never: a new kernel or core library is installed but takes effect only after you reboot, at a time you choose.
Because CentOS Stream moves ahead of RHEL and updates arrive continuously, test updates on a non-production instance first if your workload is sensitive to package changes. To stop automatic updates, run sudo systemctl disable --now dnf-automatic.timer; to update everything now, run:
sudo dnf -y upgrade
Reboot if a new kernel was installed:
sudo systemctl reboot
A new kernel boots from the logical volume like the current one: its boot entry is written to the /boot partition from /etc/kernel/cmdline (Step 4).
Step 11: Security settings on the instance
getenforce
sudo passwd -S root
sudo sshd -T | grep -E '^(permitrootlogin|passwordauthentication|pubkeyauthentication|kbdinteractiveauthentication|x11forwarding|maxauthtries|clientaliveinterval|banner) '
cat /etc/issue.net
Expected output:
Enforcing
root L 2025-04-08 0 99999 7 -1
maxauthtries 4
clientaliveinterval 300
permitrootlogin no
pubkeyauthentication yes
passwordauthentication no
kbdinteractiveauthentication no
x11forwarding no
banner /etc/issue.net
Authorized users only. All activity may be monitored and reported.

Enforcingmeans SELinux is on and enforcing the targeted policy. Keep it on; if your own software is denied, checksudo ausearch -m avc -ts recentrather than disabling SELinux.Lin the second column means the root account is locked.maxauthtries 4andclientaliveinterval 300come from the CIS profile: SSH allows four authentication attempts per connection and checks idle sessions every five minutes.- The banner text is shown before login.
- Password quality rules apply to root too (
enforce_for_root): a password that fails the quality checks is refused even when root sets it.
EC2 Serial Console and recovery. No account on this image has a password, so the serial console cannot log in until you set one. If you want serial console access, set a password for your own user on your running instance (the password is yours and is not on the image):
sudo passwd ec2-user
Step 12: Growing a volume, swap and file integrity
sudo vgs cs
df -h / /var /var/log
sudo grep -E 'cc_growpart.py.*(SKIPPED|resized|NOCHANGE)' /var/log/cloud-init.log | tail -1 | cut -c1-150
swapon --noheadings --show | wc -l
sudo grep -h aide /etc/crontab
Expected output with the default 12 GiB root volume:
VG #PV #LV #SN Attr VSize VFree
cs 1 7 0 wz--n-- 10.80g 820.00m
Filesystem Size Used Avail Use% Mounted on
/dev/mapper/cs-root 4.0G 1.9G 2.1G 48% /
/dev/mapper/cs-var 1.5G 89M 1.4G 6% /var
/dev/mapper/cs-var_log 960M 68M 893M 8% /var/log
2026-10-21 12:12:34,323 - cc_growpart.py[DEBUG]: '/' SKIPPED: Resizing mapped device (/dev/mapper/cs-root) skipped as it is not encrypted.
0
05 4 * * * root /usr/sbin/aide --check
cloud-init does not grow LVM volumes. On a single-volume CentOS Stream image cloud-init grows the root filesystem to the volume size on first boot. On this image the root filesystem is a logical volume, so cloud-init skips it (the SKIPPED line above). That is deliberate: you decide which volume gets the space. When you launch with a bigger root volume, or grow the EBS volume later with aws ec2 modify-volume, add the space in three steps on the instance:
- Grow partition 4 (the LVM physical volume) to the end of the disk, and tell LVM:
sudo growpart /dev/nvme0n1 4
sudo pvresize /dev/nvme0n1p4
- Give space to the volumes that need it.
--resizefsgrows the XFS filesystem in the same step, online, with no reboot:
sudo lvextend --resizefs -L +4G /dev/cs/root
sudo lvextend --resizefs -L +2G /dev/cs/var
- Check the result:
sudo vgs cs
df -h / /var
Example output after growing a 12 GiB volume to 20 GiB and running the commands above (the filesystem geometry that xfs_growfs prints is shortened to ...):
CHANGED: partition=4 start=2510848 old: size=22652928 end=25163775 new: size=39432159 end=41943006
Physical volume "/dev/nvme0n1p4" changed
1 physical volume(s) resized or updated / 0 physical volume(s) not resized
File system xfs found on cs/root mounted at /.
Size of logical volume cs/root changed from 4.00 GiB (1024 extents) to 8.00 GiB (2048 extents).
Extending file system xfs to 8.00 GiB (8589934592 bytes) on cs/root...
xfs_growfs /dev/cs/root
...
data blocks changed from 1048576 to 2097152
xfs_growfs done
Extended file system xfs on cs/root.
Logical volume cs/root successfully resized.
File system xfs found on cs/var mounted at /var.
Size of logical volume cs/var changed from 1.50 GiB (384 extents) to 3.50 GiB (896 extents).
Extending file system xfs to 3.50 GiB (3758096384 bytes) on cs/var...
xfs_growfs /dev/cs/var
...
data blocks changed from 393216 to 917504
xfs_growfs done
Extended file system xfs on cs/var.
Logical volume cs/var successfully resized.
VG #PV #LV #SN Attr VSize VFree
cs 1 7 0 wz--n-- 18.80g 2.80g
Filesystem Size Used Avail Use% Mounted on
/dev/mapper/cs-root 8.0G 2.0G 6.0G 25% /
/dev/mapper/cs-var 3.5G 129M 3.4G 4% /var
The new sizes persist across reboots. To give a volume all the remaining free space instead, use -l +100%FREE, for example sudo lvextend --resizefs -l +100%FREE /dev/cs/var_log. Leaving some space unallocated is useful: you can grow whichever volume fills first without touching EBS. XFS volumes grow online but cannot shrink, so add space in steps.
- Adding a data volume. Attach a new EBS volume, then give it its own volume group (for example
sudo pvcreate /dev/nvme1n1,sudo vgcreate datavg /dev/nvme1n1,sudo lvcreate -n data -l 100%FREE datavg,sudo mkfs.xfs /dev/datavg/data) and mount it from/etc/fstabby UUID with thenofailoption, so the instance still boots if the volume is ever detached. Check the device name withlsblkfirst: on Nitro instances the second EBS volume is usually/dev/nvme1n1. The image ships no LVM devices file (/etc/lvm/devices/system.devices), so LVM sees every attached disk. - Swap. The image has no swap. If your workload needs it, create a logical volume for it (for example
sudo lvcreate -L 512M -n swap cs, thensudo mkswap /dev/cs/swapand an/etc/fstabentry), or a swap file on/or/var. - AIDE. The file integrity database is built from the image's own files, and the CIS profile schedules
aide --checkdaily at 04:05 from/etc/crontab.
Step 13: Install software and add users
The instance uses the standard CentOS Stream 10 repositories (BaseOS, AppStream and Extras):
sudo dnf -q list --available nginx
Expected output (the version changes over time):
Available Packages
nginx.x86_64 2:1.26.3-15.el10 appstream
Install and start software in the usual way, for example sudo dnf -y install nginx then sudo systemctl enable --now nginx, and open its port in the security group and firewalld (Step 8). Most software installs under /usr and /etc on the root volume and keeps its data and logs under /var, so watch the / and /var volumes as you add software and grow them as needed (Step 12). The CRB repository (build and development dependencies) is installed but disabled; enable it with sudo dnf config-manager --set-enabled crb if a package needs it. The AWS CLI is not on the image; install the current version from AWS (the AWS CLI install guide) if you need it.
To add another administrator, create the account, add it to the wheel group and give it an SSH key:
sudo useradd -m -G wheel alice
sudo install -d -m 700 -o alice -g alice /home/alice/.ssh
echo "ssh-ed25519 AAAA... alice@laptop" | sudo tee /home/alice/.ssh/authorized_keys
sudo chown alice:alice /home/alice/.ssh/authorized_keys && sudo chmod 600 /home/alice/.ssh/authorized_keys
sudo restorecon -R /home/alice/.ssh
Because SSH is key-only, a new account needs its key in authorized_keys (and restorecon gives the file the SELinux label sshd expects). The new account has no password, so sudo cannot authenticate it until you give it one with sudo passwd alice. SSH stays key-only; the password is used by sudo. (Only ec2-user, created by cloud-init, has password-free sudo.)
Common use cases
- A base for workloads that must show CIS Level 1 alignment on the RHEL 10 family with the partition rules applied, not waived, and the evaluation report already on the machine
- Servers whose logs, temporary files or home directories must not be able to fill the root filesystem
- Developing and testing against what the next RHEL 10 minor release will contain, before it ships
- Fleets managed through Systems Manager, with IMDSv2 required from the first boot
- A starting point for your own golden image: add your software, re-run Step 6, and keep the report with your build
Troubleshooting
SSH says "Too many authentication failures"
The SSH server allows four authentication attempts per connection. If your SSH agent holds several keys, it can use them up before it offers the right one. Tell SSH to offer only the key you name:
ssh -o IdentitiesOnly=yes -i ~/.ssh/my-key-pair.pem ec2-user@<public-ip>
Cannot connect via SSH
- Check the instance is running and has passed its status checks.
- Check the security group allows TCP 22 from your current public address.
- Use the user name
ec2-userand the key pair chosen at launch. Password login is disabled, so a wrong key never falls back to a password prompt. - If you changed firewalld, make sure the
sshservice is still allowed. Session Manager (Step 2) still works if SSH is blocked, provided the instance has a Systems Manager instance profile.
I launched with a bigger volume but df shows the same size
That is expected on this image: cloud-init does not grow logical volumes. Follow Step 12 to grow the physical volume and then the logical volumes you choose.
A volume is full
Check which one with df -h. If the volume group has free space (sudo vgs), grow the full volume with lvextend --resizefs (Step 12). If not, grow the EBS volume first with aws ec2 modify-volume or the console, then run the three steps in Step 12.
"Permission denied" running a script or binary
/tmp, /var/tmp, /var/log and /var/log/audit are mounted noexec. Run scripts through their interpreter (bash script.sh) or move them to your home directory or /opt.
The instance does not boot on an older instance type
CentOS Stream 10 for x86_64 is built for the x86-64-v3 feature level. Very old instance families whose processors lack AVX2 cannot run it; choose a current-generation type such as m5, m6i, m7i, c6i or t3.
My service is running but not reachable
Allow the port in both the security group and firewalld (Step 8). sudo firewall-cmd --list-all shows the firewalld rules; sudo ss -tlnp shows whether the service listens on all addresses or only on loopback. If the service runs on a non-standard port, SELinux may also need to allow it: install the SELinux management tools with sudo dnf -y install policycoreutils-python-utils, then, for example, sudo semanage port -a -t http_port_t -p tcp 8080 for a web server on 8080.
A tool that uses instance metadata fails
The image requires IMDSv2. Old scripts that call http://169.254.169.254/ without a token get HTTP 401. Update them to request a token first (Step 7), or use the AWS CLI or a current SDK.
An automatic update changed something
dnf-automatic applies every update daily (Step 10). See what changed and when with sudo dnf history list and sudo dnf history info <id>; sudo dnf history undo <id> reverses a transaction while the older packages are still in the repositories.
Package manager issues
Refresh the metadata first:
sudo dnf -q makecache --refresh && echo "repository metadata refreshed"
If the repositories are unreachable, check that the instance has outbound internet access (a public IP or a NAT gateway) and that DNS resolves:
getent hosts mirrors.centos.org
Important notes
CentOS Stream is free and open source software. It is a distribution of thousands of packages, each under its own licence (GPL, LGPL, MIT, BSD, Apache 2.0 and others); rpm -qi <package> shows each package's licence. No subscription or licence key is needed to run this image. The compliance tooling is OpenSCAP (LGPL 2.1 or later) and SCAP Security Guide content (BSD 3-Clause, licence text in /usr/share/doc/cloudimg/scap-security-guide-LICENSE.txt).
CentOS Stream 10 is maintained by the CentOS Project for the life of Red Hat Enterprise Linux 10's full support phase; the CentOS Project publishes the end-of-life date. It is a continuously updated distribution that runs slightly ahead of RHEL 10, so it is not a drop-in replacement for a specific RHEL release.
The CIS Level 1 Server profile used here is the OpenSCAP profile published in SCAP Security Guide. These images are not CIS Hardened Images and are not certified by the Center for Internet Security. A pass rate measures this image as built; your own changes affect it, which is why the evaluation can be re-run (Step 6).
CentOS is a trademark of Red Hat, Inc. Red Hat Enterprise Linux is a trademark of Red Hat, Inc. CIS is a trademark of the Center for Internet Security. These names are used only to identify the software, its compatibility and the profile. cloudimg is not affiliated with or endorsed by the CentOS Project, Red Hat or the Center for Internet Security.
Support
For help with this image, contact cloudimg support:
- Website: www.cloudimg.co.uk
- User Guides: www.cloudimg.co.uk/guides
- CentOS Stream on AWS hub: www.cloudimg.co.uk/guides/centos-stream-aws