# Skip Setup For macOS, follow [Create an account and skip Setup](/porting/macos#account). The procedure below applies to iPadOS. Requires macOS image tools, a matching packed Data seed and the board's `skip_setup_tool`. Prepare them through [Building](/building). After the payload command below, run `./unixnu bootimg` and boot the newly packed image. A fresh Data seed starts the Setup app on first boot. The payload can mark Setup as done before the image is written, so the device boots to SpringBoard. ## Procedure {#procedure} 1. Prepare a matching Data seed, macOS image tools and the device's `skip_setup_tool`. Check the [build version](#build-version) and [ADT identity](#device-tree) against the selected IPSW. 2. If the seed needs resizing, complete [Data-volume preparation](/guide/userdata#data-volume) first. Record the chosen seed path. 3. Run the [payload command](#command) with `--skip-setup` and the required device inputs. Check [output](#output): `payload.json` must contain `"skip_setup": true`. 4. Run `./unixnu bootimg`, boot the new image and perform [verification](#verify). Record the seed, image revision and observed userland stage. ## Command ```sh ./unixnu build payload \ --data-ramdisk data.dbr \ --skip-setup \ --trust-cache trustcache.img \ --unique-chip-id ``` `--skip-setup` requires `--data-ramdisk`. The payload step reads `[payload] skip_setup_tool` from the board file and runs it on a copy of the seed. ```toml [payload] skip_setup_tool = "scripts/seed-data-skip-setup.py" skip_setup_args = ["--no-auto-dim"] ``` `skip_setup_args` is optional and passed to the tool after the two paths. The original seed stays unchanged. The payload uses the edited copy as `Payloads/scratch-data.img`. Grow the seed first with `scripts/seed-data-grow.py` when the tablet's storage is larger than the seed. The payload edits the grown seed and keeps its size. ## What the tool changes `scripts/seed-data-skip-setup.py` expands the packed APFS Data seed, attaches it read-write, merges preferences into `/private/var/mobile/Library/Preferences`, and packs the result again. | Preference file | Values | | --- | --- | | `com.apple.purplebuddy` | `SetupDone = true`, `SetupFinishedAllSteps = true`, `SetupVersion = 11`, `daemonizeNeedsToRun = false` | | `com.apple.purplebuddy.notbackedup` | Every mini-buddy flag is `false`: diagnostics, HSA2, keychain sync, Mesa, payment, standard, silent ICDP | | `com.apple.managedconfiguration.notbackedup` | `LockdownActivationIndicatesCloudConfigurationAvailable = false` | | `com.apple.springboard` | `BKNoWatchdogs = true`, `FBLaunchWatchdogExceptions = { com.apple.purplebuddy: 100 }`, `MCForceShowCloudConfigurationUI = false` | | `com.apple.migration` | `LastSystemVersion = 21H461`, `DMUserDataDisposition = { SyntheticDidUpgrade = false, buildVersion = 21H461 }` | `--no-auto-dim` also sets `SBDisableAutoDim`, `SBDontDimOrLockOnAC` and `SBDisableIdleSleep` in `com.apple.springboard`, as UniXNU-qemu's root builder does. A board without buttons or a working idle timer otherwise turns its display off about 30 seconds after SpringBoard starts and puts the system to sleep. The tool also creates these directories under `/private/var/containers`: ``` Bundle Data/System Shared/SystemGroup Temp ``` The volume UUID stays the same. The APFS container magic is checked again after the edit. ## Build version The script sets: ```python BUILD, VERSION = '21H461', '17.7.11' ``` Update both values when the board targets a different iOS build. `LastSystemVersion` and `DMUserDataDisposition.buildVersion` must match the IPSW. ## Device tree The supplied format 2 OS profile sets these typed `/chosen` properties. Format 1 ADT tools select them through `--ipad-identity`: | Property | Value | | --- | --- | | `certificate-production-status` | `0` | | `effective-production-status-ap` | `0` | | `certificate-security-mode` | `1` | | `effective-security-mode-sep` | `1` | These describe a development-fused, undemoted board. `mobileactivationd` reads them through MobileGestalt and takes its native activation path without an activation record. The other identity properties and their cached answers are in [MobileGestalt identity](/guide/mobilegestalt). ## Jobs On sheng with iPadOS 27.0.1 (24A446), `lite=1` keeps `iconservicesagent` available on demand. IconRendering uses Metal. The job sets `FORCE_SOFTWARE_RENDERER=0` and `CI_ENABLE_METAL_GPU=0`. The stock J820 profile gives the agent a 15 MiB inactive hard limit and a 1,224 MiB active soft limit. With `lite=2`, launchd disables the icon service. The Home Screen and Dock show icon backgrounds without app artwork. Settings still opens. To disable individual jobs, pass their launchd labels as a comma-separated list. ``` disable-jobs=com.apple.identityservicesd,com.apple.locationd ``` ## Output The payload directory contains: ``` out////payload/data-skip-setup-.dbr out////payload/payload.img out////payload/payload.json ``` `payload.json` records: | Field | Meaning | | --- | --- | | `data_ramdisk_sha256` | Hash of the edited seed | | `skip_setup` | `true` | | `payload_sha256` | Payload image hash | The edited seed is cached by the hash of the original and of `skip_setup_args`. A different seed or different arguments produce a new file. ## Verify 1. Build the payload with `--skip-setup`. 2. Check `payload.json` has `"skip_setup": true`. 3. Run `./unixnu bootimg`, then boot the newly packed image. 4. The log reaches SpringBoard instead of the Setup pages. The reference implementation is `scripts/seed-data-skip-setup.py` in this repository. ## Next steps - [Boot the image](/guide/boot) - [Userdata image](/guide/userdata) - [Payload](/concepts/payload)