docs: Update handling of LXD/Docker incompatibility
Metadata
Current evaluation
Merged PR canonical/rockcraft#1148 (7e896a30) added LXD/Docker forwarding guidance, official LXD documentation, firewall warnings, and removed the alternate-method warning.
Resolution: closed resolved
Reason: PR canonical/rockcraft#1148 was merged as commit 7e896a30 and resolved #1144 by implementing the requested setup documentation changes.
Evaluated by: mr-cal-bot
No scores available.
Issue body
### Check existing issues
- [x] I've verified that this request isn't described by any existing issues.
### Request
We need to add the following steps to the setup instructions, after LXD has been set up but before Docker is installed:
```
echo "net.ipv4.conf.all.forwarding=1" \
| sudo tee -a /etc/sysctl.d/99-forwarding.conf
sudo systemctl restart systemd-sysctl
```
We also need to:
- Include the link to the [LXD documentation](https://documentation.ubuntu.com/lxd/stable-5.21/howto/network_bridge_firewalld/#prevent-connectivity-issues-with-lxd-and-docker) about the known issue.
- Add a warning admonition that in a production environment you should have a hardened firewall configuration.
- Remove the warning admonition under the first rock-packing with the alternate method.
### Related issues and PRs
#598 #1110
### Document location
https://documentation.ubuntu.com/rockcraft/latest/tutorial/
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| stealth/space-bunny-alpha | — | closed resolved | Merged PR canonical/rockcraft#1148 (7e896a30) added LXD/Docker forwarding guidance, official LXD documentation, firewall warnings, and removed the alternate-method warning. | |
| stealth/space-bunny-alpha | — | closed resolved | Merged PR #1148 (commit 7e896a30) updated Rockcraft setup docs with LXD/Docker forwarding steps, official LXD guidance, firewall warnings, and the requested admonition changes. | |
| qwen/qwen3.6-35b-a3b | — | — | Documentation updates for LXD/Docker incompatibility were implemented in PR #1148. The issue was closed as superseded by the merged pull request, which added sysctl configuration steps, linked official LXD docs, and updated warning admonitions. | |
| qwen/qwen3.6-35b-a3b | — | — | Merged via PR #1148. Documentation was updated to include sysctl forwarding steps, link to LXD compatibility notes, and adjust warning admonitions as requested. | |
| qwen/qwen3.6-35b-a3b | — | — | Resolved via PR #1148. Documentation was updated to include sysctl forwarding steps, upstream LXD compatibility links, and revised warning admonitions for the LXD/Docker setup process. | |
| qwen3.6-35b-a3b-mtp-q6 | — | — | Closed as superseded by merged PR #1148. The pull request implemented the requested documentation updates, adding the sysctl forwarding configuration, linking to official LXD documentation, and adjusting warning admonitions for the LXD/Docker incompatibility. |
Update history
No update history recorded yet.
Related work
-
Likely Fixed By:
canonical/rockcraft#1148
(confidence 100%)
Merged commit 7e896a30 implements the requested documentation updates and closed the issue.
-
Related To:
canonical/rockcraft#1110
(confidence 95%)
Earlier documentation PR for reusing the LXD/Docker networking troubleshooting guidance was superseded by #1148.
-
Related To:
canonical/rockcraft#598
(confidence 90%)
Earlier report about inadequate LXD/Docker networking guidance, also resolved by the documentation added in #1148.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #1148 docs: update LXD/Docker incompatibility handling | rockcraft | merged | Merged in canonical/rockcraft#1148 as 7e896a30, centralizing LXD/Docker connectivity guidance and firewall warnings in shared setup docs; it closed #1144. | |
| #1061 docs: Update LXD/Docker warning block in 12-factor tutorials | rockcraft | merged | Merged PR #1061 as ce44c500, updating all 12-factor tutorial LXD/Docker warnings with clearer bridge setup, an environment variable, and sudo commands. | |
| #7 fix: upgrade LXD to an existing channel | craft-actions | merged | Merged PR #7 in commit 937d4f6, fixing #6 by switching Rockcraft's LXD channel from unavailable 5.9/stable to latest/stable. |