refact: renamed partition to slot

Author: simonwalz

create-lxc-image.sh

@@ -3,7 +3,7 @@
 set -x
 set -o pipefail
 
-PARTITION="A"
+SLOT="A"
 
 raise() {
 	echo "Error: $*" >&2
@@ -73,7 +73,7 @@ docker run -it -d \
 	--restart=always \
 	--name "${CONTAINER_NAME}" \
 	"${IMAGE_VERSION}" || raise "Failed to run container"
-docker exec "${CONTAINER_NAME}" /usr/local/cuos/first-run.sh "${PARTITION}" "${IMAGE_VERSION}" "${NEW_DIGEST}" \
+docker exec "${CONTAINER_NAME}" /usr/local/cuos/first-run.sh "${SLOT}" "${IMAGE_VERSION}" "${NEW_DIGEST}" \
 	|| raise "Failed to run first-run script in container"
 
 docker cp "${CONFIG_PATH}" "${CONTAINER_NAME}:/data/system_A.json" \

docs/architecture.md

@@ -22,7 +22,7 @@ Core building blocks:
 | Update Layer | Updater image (`updater_image`) | Prepare new subvolume + boot switch, digest checks |
 | Persistence | BTRFS subvolumes `@os`, `@data`, `@swap` | Separate replaceable system from stable data |
 | Config files | `/system.json`, `/system_next.json` | Active vs staged (rollback) configuration |
-| Status files | `/data/state.json`, `/etc/partition_mode` | Runtime state + active slot indicator |
+| Status files | `/data/state.json`, `/etc/active_slot` | Runtime state + active slot indicator |
 
 ---
 
@@ -32,7 +32,7 @@ Core building blocks:
 |------|---------|
 | `/usr/local/cuos/` | CuOS scripts (install, update, API, init) |
 | `/etc/image` | Current system image reference |
-| `/etc/partition_mode` | Logical slot (A/B) |
+| `/etc/active_slot` | Logical slot (A/B) |
 | `/system.json` | Active configuration |
 | `/system_next.json` | Staging / rollback configuration |
 | `/data/` | Persistent data (logs, docker, state) |

docs/common/cuos-app-init.md

@@ -43,12 +43,9 @@ Its value replaces the default Docker run argument block (still augmented with s
 Default:
 
 ```shell
---device /dev/tty7 \
---network host \
 --volume /var/run/docker.sock:/var/run/docker.sock \
 --volume /root/.docker/config.json:/root/.docker/config.json:ro \
 --volume /system.json:/system.json:ro \
---volume /etc/partition_mode:/etc/partition_mode:ro \
 --volume /var/run/cuos.sock:/var/run/cuos.sock \
 --volume /usr/local/share/ca-certificates/custom:/usr/local/share/ca-certificates/custom:ro
 ```
@@ -60,6 +57,7 @@ Suggestions for more parameters:
 --user myuser:mygroup \
 --read-only \
 --tmpfs /etc/ssl/certs:rw,noexec,nosuid,size=16m
+--tmpfs /tmp:rw,size=64m
 ```
 
 ### Entrypoint

docs/common/glossary.md

@@ -23,7 +23,7 @@ Canonical terminology used across the CuOS project. Use these precise forms in d
 | State File | `/data/state.json` persisted state metadata | Mutated by core scripts |
 | Config File | `/system.json` active configuration | Source of truth after merges/patches |
 | Next Config File | `/system_next.json` rollback / staging config | Swapped during updates |
-| Partition Mode File | `/etc/partition_mode` indicating active slot name | Used by update & rollback logic |
+| Active Slot File | `/etc/active_slot` indicating active slot name | Used by update & rollback logic |
 | Trigger File | `/data/run-update` forces app container refresh | Created by API patch/update logic |
 | API Socket | `/var/run/cuos.sock` UNIX domain socket for commands | JSON line based protocol |
 | Resources Command | `cuos resources` JSON system metrics | CPU / memory / disk / network summary |
@@ -56,7 +56,7 @@ Canonical terminology used across the CuOS project. Use these precise forms in d
 | `/data/` | Persistent root (logs, docker, state) |
 | `/data/log/` | Journald persistent logs (via symlink) |
 | `/etc/image` | Current active system image reference string |
-| `/etc/partition_mode` | Current active slot indicator (logical A/B) |
+| `/etc/active_slot` | Current active slot indicator (logical A/B) |
 | `/var/run/cuos.sock` | API communication socket |
 | `/usr/local/cuos/` | Core CuOS scripts and helpers |
 

docs/common/update-process.md

@@ -136,7 +136,7 @@ Rollback actions:
 | `/system.json` | Active configuration |
 | `/system_next.json` | Staging / rollback source |
 | `/etc/image` | Active OS image label |
-| `/etc/partition_mode` | Active slot indicator |
+| `/etc/active_slot` | Active slot indicator, A or B |
 | `/data/run-update` | App restart trigger |
 | `/data/state.json` | Runtime state |
 

docs/variants/variant1.md

@@ -11,7 +11,7 @@ A minimal CuOS-based system consists of:
 
 Key Features:
 - Minimal OS based on Debian
-- A/B partition scheme for safe updates
+- A/B slot scheme for safe updates
 - BTRFS filesystem for snapshots
 - Full systemd integration
 - Network configuration support
@@ -178,15 +178,15 @@ RUN apt-get update && apt-get install --no-install-recommends -y \
 
 ### Update Mechanism
 
-The update system uses an A/B partition scheme for safe system updates. This allows for:
+The update system uses an A/B slot scheme for safe system updates. This allows for:
 - Low-downtime updates
 - Automatic rollback on failure
 - Verified boot process
 
 #### Update Process
 
-1. System determines current active partition (A or B)
-2. Downloads new image to inactive partition
+1. System determines current active slot (A or B)
+2. Downloads new image to inactive slot
 3. Updates boot configuration
 4. Reboots into new system
 5. Verifies boot success or rolls back
@@ -203,12 +203,12 @@ docker run \
   -v /root/.docker/config.json:/root/.docker/config.json:ro \
   -v /etc/image:/etc/image:ro \
   -e "TARGET_DEVICE=${TARGET_DEVICE}" \
-  ghcr.io/cuos-dev/cuos-updater:latest "${PARTITION}" "${IMAGE_VERSION}" "${IMAGE_DIGEST}"
+  ghcr.io/cuos-dev/cuos-updater:latest "${SLOT}" "${IMAGE_VERSION}" "${IMAGE_DIGEST}"
 ```
 
 Parameters:
 - **TARGET_DEVICE**: Block device to update (e.g., `/dev/sda`)
-- **PARTITION**: Current active partition ("A" or "B")
+- **SLOT**: Current active slot ("A" or "B")
 - **IMAGE_VERSION**: Full image reference to install
 - **IMAGE_DIGEST**: SHA256 digest for verification (optional)
 
@@ -231,4 +231,4 @@ Parameters:
 
 - Learn about [creating custom update policies](../common/update-system.md)
 - Explore [advanced boot configurations](../common/boot-config.md)
-- See how to [customize the installation process](../common/installation-media.md)
+- See how to [customize the installation process](../common/installation-media.md)

docs/variants/variant2.md

@@ -13,7 +13,7 @@ A minimal CuOS-based system consists of:
 
 Key Features:
 - Minimal OS based on Debian
-- A/B partition scheme for safe updates
+- A/B slot scheme for safe updates
 - BTRFS filesystem for snapshots
 - Full systemd integration
 - Network configuration support
@@ -226,4 +226,4 @@ See [Building CuOS Images](../common/building-images.md)
 
 - Learn about [advanced API usage](../common/api-reference.md)
 - Explore [system monitoring](../common/monitoring.md)
-- Set up [custom update policies](../common/update-system.md)
+- Set up [custom update policies](../common/update-system.md)

image-factory/create_image.sh

@@ -84,7 +84,7 @@ OS_DIGEST="$(jq -r --arg arch "${OS_ARCH}" '.[$arch+"_image_digest"] // .os_imag
 
 if [[ "${OS_ARCH}" == "lxc" ]]; then
   IMAGE="${IMAGE/img/tar.gz}"
-  PARTITION="A"
+  SLOT="A"
 
   docker image pull "${OS_IMAGE}" || raise "Faild to fetch image"
   IMAGE_DIGEST="$(docker inspect --format='{{index .RepoDigests 0}}' "${OS_IMAGE}" 2>/dev/null | cut -d '@' -f 2)"
@@ -98,7 +98,7 @@ if [[ "${OS_ARCH}" == "lxc" ]]; then
     --pull=never \
     --name "${CONTAINER_NAME}" \
     "${OS_IMAGE}" || raise "Failed to run container"
-  docker exec "${CONTAINER_NAME}" /usr/local/cuos/first-run.sh "${PARTITION}" "${OS_IMAGE}" "${IMAGE_DIGEST}" \
+  docker exec "${CONTAINER_NAME}" /usr/local/cuos/first-run.sh "${SLOT}" "${OS_IMAGE}" "${IMAGE_DIGEST}" \
     || raise "Failed to run first-run script in container"
 
   docker cp "${CONFIG_PATH}" "${CONTAINER_NAME}:/system_init.json" \
@@ -114,7 +114,7 @@ if [[ "${OS_ARCH}" == "lxc" ]]; then
   exit 0
 fi
 
-PARTITION="B"
+SLOT="B"
 
 #SIZE_MB=2048
 SIZE_MB=4096
@@ -194,7 +194,7 @@ umount /mnt/root
 
 export INSTALLIMAGE=true
 /usr/local/updater/updater.sh \
-	"${PARTITION}" \
+	"${SLOT}" \
 	"${OS_IMAGE}" \
 	"${OS_DIGEST}"
 

system/cuos/api.sh

@@ -47,11 +47,11 @@ EOF
     VERSION="$(cat "/etc/image")"
     VERSION="${VERSION/*\//}"
     VERSION="${VERSION/@*/}"
-    PARTITION="$(cat "/etc/partition_mode")"
+    SLOT="$(cat "/etc/active_slot")"
     jq \
-      --arg partition "${PARTITION}" \
+      --arg slot "${SLOT}" \
       --arg version "${VERSION}" \
-      '.partition = $partition | .version = $version' \
+      '.slot = $slot | .version = $version' \
        "/data/state.json"
   ;;
 
@@ -120,7 +120,7 @@ EOF
         "${CONFIG_PATH}" || exit 0
     fi
 
-    # apply changes to current partition
+    # apply changes to current slot
     "${SCRIPT_DIR}/init.sh" --reinit
   ;;
 

system/cuos/app-init.sh

@@ -151,12 +151,9 @@ if ! docker ps --format '{{.Names}}' | grep -q "^${CONTAINER_NAME}\$"; then
     DOCKER_ARGS="$(docker inspect --format '{{ index .Config.Labels "dev.cuos.app_command" }}' "${INITIAL_IMAGE}")"
     if [[ -z "${DOCKER_ARGS}" ]]; then
       DOCKER_ARGS="\
-        --device /dev/tty7 \
-        --network=host \
         --volume /var/run/docker.sock:/var/run/docker.sock  \
         --volume /root/.docker/config.json:/root/.docker/config.json:ro  \
         --volume /system.json:/system.json:ro  \
-        --volume /etc/partition_mode:/etc/partition_mode:ro  \
         --volume /var/run/cuos.sock:/var/run/cuos.sock  \
         --volume /usr/local/share/ca-certificates/custom:/usr/local/share/ca-certificates/custom:ro"
     fi