Storage

Energy SOAR stores file attachments (case attachments, observable files, reports) on the local filesystem. Storage is configured in /etc/energysoar/application.conf.d/storage.conf.

Default configuration

storage {
  provider: localfs
  localfs.location: /opt/energysoar/files
}

The localfs.location directory is created by the installer. Ensure sufficient disk space is available at this path. For production deployments, mount a dedicated volume at /opt/energysoar/files before installation.

Changing the storage path

To use a different directory:

  1. Stop the service:

    systemctl stop energysoar
    
  2. Edit /etc/energysoar/application.conf.d/storage.conf and update localfs.location.

  3. Move existing files to the new location:

    mv /opt/energysoar/files /new/path/files
    
  4. Start the service:

    systemctl start energysoar
    

Warning

Do not change the storage path on a running system. Existing attachments will become inaccessible if files are not moved before restarting.