Skip to content
Documentation

Import/Export

Rackula stores data locally in your browser. Use import/export to backup your work, share with others, or move between devices.

Export formats

Section titled “Export formats”

Images

Section titled “Images”

Best for: Documentation, sharing, presentations

  • Raster image format
  • Fixed resolution (configurable)
  • Universal compatibility

Data

Section titled “Data”

Best for: Backups, version control, programmatic access

  • Complete rack data
  • Human-readable format
  • Can be imported back into Rackula

Exporting

Section titled “Exporting”

Export current rack

Section titled “Export current rack”
  1. Click Export in the toolbar
  2. Select your format
  3. Configure export options (if applicable)
  4. Click Download

Export all racks

Section titled “Export all racks”
  1. Click Export in the toolbar
  2. Enable Export All Racks
  3. Choose format and download

Importing

Section titled “Importing”

From JSON backup

Section titled “From JSON backup”
  1. Click Import in the toolbar
  2. Select your JSON file
  3. Choose import mode:
    • Replace: Overwrites current project
    • Merge: Adds imported racks to current project

From URL

Section titled “From URL”

Rackula supports loading layouts from URLs. Share a link to your hosted JSON file and others can import directly.

Data storage

Section titled “Data storage”

Browser storage

Section titled “Browser storage”

Rackula stores your data in browser localStorage. This means:

  • Data persists across browser sessions
  • Data is local to your device and browser
  • Clearing browser data will delete your layouts

Storage limits

Section titled “Storage limits”

Browser localStorage typically allows 5-10MB. This is sufficient for hundreds of racks with thousands of devices.

Sharing layouts

Section titled “Sharing layouts”

Direct sharing

Section titled “Direct sharing”
  1. Export your layout as JSON
  2. Share the file via email, Slack, etc.
  3. Recipient imports the JSON file
Section titled “Link sharing”

Host your exported JSON file (GitHub Gist, Dropbox, etc.) and share the URL. Others can import directly from the URL.

Version control

Section titled “Version control”

For teams, consider storing exports in Git:

Terminal window
# Export and commit
rackula export > homelab-rack.json
git add homelab-rack.json
git commit -m "Update rack layout"

This provides:

  • Change history
  • Collaboration via pull requests
  • Rollback capability

Next steps

Section titled “Next steps”