NgTech-LTD/gns3-server
2
0
Fork 0
mirror of https://github.com/GNS3/gns3-server.git synced 2026-09-04 00:55:16 +03:00
Code Issues Packages Projects Releases Wiki Activity
gns3-server/.claude/memory/gns3-appliance-loading.md
YueGuobin dc04c29e7e
docs: add GNS3 appliance loading mechanism to memory 
Document how GNS3 loads appliance files from builtin and custom directories with priority rules, including storage locations and the design rationale that allows users to customize devices without losing changes during registry updates.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-24 22:31:28 +08:00

1004 B
Raw Blame History

name, description, metadata
name description metadata
gns3-appliance-loading GNS3 appliance file loading mechanism and storage locations
type
reference

GNS3 loads appliance (.gns3a) files from two locations with specific priority order:

  1. Builtin appliances directory: ~/.local/share/GNS3/appliances/

    • Stores automatically downloaded devices from GNS3 registry
    • Maintained and updated by the system automatically

  2. Custom appliances directory: ~/GNS3/appliances/

    • Stores user-customized or modified appliance files
    • Manually managed by users

Loading priority: System loads builtin appliances first, then custom appliances. If both directories contain devices with the same device_id, the custom appliance overwrites the builtin one. This design allows users to customize devices without having their modifications overwritten by automatic registry updates.

Implementation: See gns3server/controller/appliance_manager.py in the load_appliances() method (lines 314-351).