← Back to issue list

Documentation for network connectivity

View original Github issue

Metadata

Project
craft-providers
Number
#583
Type
issue
State
open
Author
mr-cal
Labels
Type: Documentation
Created
Updated
Closed
—

Current evaluation

Open documentation request to add network connectivity troubleshooting guides for LXD and Multipass. The how-to docs are empty; only a partial Docker/iptables note exists in explanation/.

Suggested action: keep open

Reason: This is a valid, well-scoped documentation request opened by maintainer mr-cal. The how-to docs are empty (docs/how-to/index.rst has only a toctree placeholder), and only a partial Docker/iptables note exists in docs/explanation/index.rst. No commits have addressed this request, and no related issues were found.

Evaluated by: mr-cal-bot

Impact: 40 Quick Win: 26 Complexity: 20 Confidence: 80 Actionability: 80

Issue body

### What needs to get done Write documentation to enable users to debug LXD and Multipass issues. There are 2 common scenarios: 1. Can't launch a container or vm * Document launching a LXD container or Multipass vm outside of the *craft app 2. Can't connect to the network * Document launching a LXD container or Multipass vm, opening a shell, and checking for network connectivity * Advise against the usual culprits: proxies, vpns, firewalls, and docker ### Why it needs to get done Users often start by troubleshooting the *craft application itself and eventually figure out the problem is with LXD or Multipass. This chain of redirection and troubleshooting could be dramatically shortened with good documentation.

Evaluation history

Date Model Scores Action Summary
qwen/qwen3.6-35b-a3b
Impact: 40
Quick Win: 26
Complexity: 20
Confidence: 80
Actionability: 80
keep open Open documentation request to add network connectivity troubleshooting guides for LXD and Multipass. The how-to docs are empty; only a partial Docker/iptables note exists in explanation/.
stealth/space-bunny-alpha
Impact: 45
Quick Win: 25
Complexity: 28
Confidence: 80
Actionability: 76
keep open Doc request still open: docs/how-to toctree is empty. Only a partial Docker/iptables note exists in explanation/ (PR #185); requested LXD/Multipass launch, shell, and connectivity troubleshooting steps are still missing.
stealth/space-bunny-alpha
Impact: 45
Quick Win: 25
Complexity: 30
Confidence: 92
Actionability: 80
keep open Maintainer-authored documentation request remains open; launch, shell, and connectivity troubleshooting for LXD and Multipass is not yet covered.
stealth/space-bunny-alpha
Impact: 48
Quick Win: 26
Complexity: 35
Confidence: 90
Actionability: 83
keep open Requested troubleshooting documentation for LXD and Multipass launch and network failures remains open, covering direct VM launches, guest connectivity checks, and common interference sources.
qwen3.6-35b-a3b-mtp-q6
Impact: 65
Quick Win: 42
Staleness: 75
Complexity: 35
Confidence: 65
Support Request: 15
keep open Documentation request to help users debug LXD and Multipass network connectivity issues. Open 806 days with minimal maintainer engagement.
qwen/qwen3.6-35b-a3b
Staleness: 85
Complexity: 20
Confidence: 80
Support Request: 10
close stale Documentation request to guide users in debugging LXD and Multipass network issues. Currently unimplemented and inactive for over two years with only automated Jira sync activity.
qwen3.6-35b-a3b-mtp-q6
Staleness: 85
Complexity: 15
Confidence: 75
Support Request: 5
needs triage Request to document debugging steps for LXD and Multipass network connectivity issues to help users troubleshoot outside the craft app. Currently unassigned and inactive since a Jira sync bot comment.

Update history

No update history recorded yet.

Related issues

No related issues found above the similarity threshold.