Current Maps Location
{{ maps_base_dir }}
This is where VelocityCMDB looks for your network topology maps.
Directory Structure
Maps are organized by site folders. Each subfolder in the maps directory becomes a site group in the UI.
{{ maps_base_dir }}
βββ datacenter-east/
β βββ core-topology.svg
β βββ wan-connections.svg
β βββ dmz-network.svg
βββ datacenter-west/
β βββ full-topology.svg
βββ branch-offices/
β βββ seattle.svg
β βββ portland.svg
βββ thumbnails/
βββ ...
Supported File Formats
Note: An SVG file is required for the map to appear. Maps without SVG files are hidden from the UI.
Thumbnails
Thumbnails are generated automatically when you first view a map. They are cached in:
{{ maps_base_dir }}/thumbnails/
- Thumbnails regenerate if the source SVG is newer than the cached thumbnail
- Use the "Rebuild Thumbnails" button to force regeneration of all thumbnails
- Do not manually edit the thumbnails folder β it's managed by the application
Adding New Maps
- Create a site folder (if it doesn't exist) inside the maps directory
- Copy or save your SVG file into the site folder
- Refresh this page β your map will appear automatically
- Optionally add matching .json, .graphml, or .drawio files with the same base name
Example: Adding a new map
# Create a new site folder
mkdir "{{ maps_base_dir }}/my-new-site"
# Copy your SVG map into it
cp my-diagram.svg "{{ maps_base_dir }}/my-new-site/"
# Optional: Add companion files
cp my-diagram.json "{{ maps_base_dir }}/my-new-site/"
Common Issues
Map doesn't appear
Ensure it's an SVG file inside a site subfolder, not in the root maps directory
Thumbnail not showing
Click "Rebuild Thumbnails" or wait for automatic generation on first view
Map shows as empty
SVG file may be too small (<10KB) or corrupted β verify it opens in a browser