diff --git a/ic-os/README.adoc b/ic-os/README.adoc
index 1c78b11ae9a..d6d8066c508 100644
--- a/ic-os/README.adoc
+++ b/ic-os/README.adoc
@@ -83,6 +83,14 @@ The docker image is then transformed into a bootable "bare-metal" or "virtual-me
 Note that all pre-configuration of the system is performed using docker utilities, and the system is actually also operational as a docker container.
 This means that some development and testing could be done on the docker image itself, but an actual VM image is still required for proper testing.
 
+== Adding a new dependency to an ICOS image
+
+To add a new package to an ICOS image you need to:
+
+   * Update the list of packages to install in `ic/ic-os/{setupos,hostos,guestos,boundary-guestos}/rootfs/packages.common`
+   ** Commit the changes and wait for CI to publish the base image
+   * Update the base image hash in `ic/ic-os/{setupos,hostos,guestos,boundary-guestos}/rootfs/docker-base.<env>`  
+
 == IC-OS Directory Organization
 
 * *bootloader/*: This directory contains everything related to building EFI firmware and the GRUB bootloader image. It is configured to support the A/B partition split on upgradable IC-OS images (HostOS, GuestOS, and potentially Boundary-guestOS)