Docs: Tutorials assume an `amd64` host which causes `platforms:` and `.rock` filenames break for `arm64` readers
Metadata
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.