← Back to issue list

Docs: Tutorials assume an `amd64` host which causes `platforms:` and `.rock` filenames break for `arm64` readers

View original Github issue

Metadata

Project
rockcraft
Number
#1280
Type
issue
State
open
Author
minulo
Labels
Created
Updated
Closed

Current evaluation

Documentation tutorials hardcode amd64 in platforms and .rock filenames, breaking for arm64 users. Issue assigned to contributor who is actively working on a fix.

Suggested action: keep open

Reason: The issue was assigned by maintainer @asanvaq on 2026-07-06, and the author @minulo provided a scope update on 2026-07-07 confirming work is in progress on a PR covering Hello World, Pack a Python package, and Node.js app tutorials. This is an active, triaged documentation fix being worked on.

Impact: 40 Quick Win: 34.0 Staleness: 15 Complexity: 15 Confidence: 85 Support Request: 0

Issue body

### Check existing issues - [x] I've verified that this request isn't described by any existing issues. ### Request ## Summary Several Rockcraft tutorials hardcode `amd64` in the `rockcraft.yaml` `platforms:` block and in the resulting `.rock` filenames used by later commands. A reader on an `arm64` host (e.g. Apple Silicon macOS, which is the majority of current Macs) packs a `..._arm64.rock` file, so the copy-paste `skopeo` import commands which reference `..._amd64.rock`, and this fails with a file-not-found error. ## Steps to reproduce ### Environment - Host architecture: `arm64` (Apple Silicon) - Build VM: Multipass (Ubuntu 24.04) - Docs version: `1.19` ### Reproduction: Using "Pack a Python package" as the clearest example: 1. In "Setup your environment," select the **macOS** tab (as an Apple Silicon user would). 2. Follow through to the `rockcraft.yaml` snippet: ```yaml platforms: arm64: ``` 3. Run `rockcraft pack` on the `arm64` host/VM. 4. Observe the produced file is `pyfiglet_0.7.6_arm64.rock`. 5. Run the import command exactly as written: ``` sudo rockcraft.skopeo --insecure-policy copy oci-archive:pyfiglet_0.7.6_amd64.rock docker-daemon:pyfiglet:0.7.6 ``` → fails, because the file on disk is `..._arm64.rock`. The Hello World and Chisel tutorials reproduce the same way with their respective filenames. ## Suggested fix Apply one consistent approach across the affected tutorials, changing from ``` sudo rockcraft.skopeo --insecure-policy copy oci-archive:hello_latest_amd64.rock docker-daemon:hello:latest ``` to something that use $(dpkg --print-architecture) like ``` sudo rockcraft.skopeo copy \ --insecure-policy \ oci-archive:hello_latest_$(dpkg --print-architecture).rock \ docker-daemon:hello:latest ``` ### Document location https://documentation.ubuntu.com/rockcraft/1.19/tutorial/hello-world/

Evaluation history

Date Model Scores Action Summary
qwen3.6-35b-a3b-mtp-q6
Impact: 40
Quick Win: 34.0
Staleness: 15
Complexity: 15
Confidence: 85
Support Request: 0
keep open Documentation tutorials hardcode amd64 in platforms and .rock filenames, breaking for arm64 users. Issue assigned to contributor who is actively working on a fix.
qwen/qwen3.6-35b-a3b
Staleness: 10
Complexity: 15
Confidence: 90
Support Request: 5
keep open Documentation tutorials hardcode amd64 architectures in platforms blocks and rock filenames, causing failures for arm64 users. A maintainer has assigned the issue and the author is actively working on a PR to fix the affected tutorials.
qwen3.6-35b-a3b-mtp-q6
Staleness: 5
Complexity: 10
Confidence: 95
Support Request: 0
keep open Documentation issue where tutorials hardcode amd64 in platforms and filenames, breaking arm64 users. Author is actively working on a PR to fix this with maintainer guidance.
qwen3.6-35b-a3b-mtp-q6
Staleness: 5
Complexity: 15
Confidence: 90
Support Request: 10
needs triage Documentation tutorials hardcode amd64 architecture in platform definitions and rock filenames, causing copy-paste commands to fail for arm64 users. Author has offered to submit a fix.

Update history

No update history recorded yet.

Related work

  • Related To: rockcraft#1222 (confidence 80%)

    PR #1222 removed the 'Shrink a rock with Chisel' tutorial from main, which the author notes is excluded from this fix.

Related issues

No related issues found above the similarity threshold.