Struct ConfigData 

pub struct ConfigData {

    pub internal_url: String,
    pub external_url: String,
    pub internal_url_enabled: bool,
    pub external_url_enabled: bool,
    pub watch_paths: Vec<WatchPathEntry>,
    pub run_on_startup: bool,
    pub pause_on_metered_network: bool,
    pub pause_on_battery_power: bool,
    pub background_sync_enabled: bool,
    pub notifications_enabled: bool,
    pub startup_catchup_mode: StartupCatchupMode,
    pub upload_concurrency: u8,
    pub quiet_hours_start: Option<u8>,
    pub quiet_hours_end: Option<u8>,
    pub library_view_enabled: bool,
    pub download_target_path: Option<String>,
    pub library_preview_full_resolution: bool,
    pub library_grid_quality: String,
    pub cache_disk_cap_mb: u32,
    pub raw_decode_cache_enabled: bool,
    pub raw_full_decode: bool,
    pub show_unnamed_faces: bool,
    pub show_hidden_faces: bool,
    pub upload_xmp_sidecars: bool,
    pub grid_border_width: f32,
    pub grid_border_color: String,
}

Configuration schema driving application behavior and connection settings.

Fields

internal_url: String

Active local Immich server connection address.

external_url: String

Active remote or external connection address.

internal_url_enabled: bool

True if internal URL connection is enabled.

external_url_enabled: bool

True if external URL connection is enabled.

watch_paths: Vec<WatchPathEntry>

List of watched local directory entries.

run_on_startup: bool

True if application should launch automatically at user login.

pause_on_metered_network: bool

Pause transfers when metered connections are detected.

pause_on_battery_power: bool

Pause transfers when system runs on battery.

background_sync_enabled: bool

Whether automatic background monitoring/upload discovery is enabled.

notifications_enabled: bool

Whether desktop notifications (sync summary, connectivity lost, etc.) are shown.

startup_catchup_mode: StartupCatchupMode

Default catch-up scanning strategy when background scan starts.

upload_concurrency: u8

Number of parallel upload workers (1–10). Defaults to 3.

quiet_hours_start: Option<u8>

Quiet-hours window start (local clock hour, 0-23). None means disabled.

quiet_hours_end: Option<u8>

Quiet-hours window end (local clock hour, 0-23, exclusive).

library_view_enabled: bool

Whether the built-in library viewer is the primary window.

download_target_path: Option<String>

Target folder for asset downloads from the library viewer.

library_preview_full_resolution: bool

When true, lightbox loads original full-resolution image instead of preview.

library_grid_quality: String

Grid thumbnail quality: “auto”, “thumbnail”, “preview”. Defaults to auto.

cache_disk_cap_mb: u32

Total on-disk cache cap in megabytes across all subcaches (thumbnails, raw_decode, exif, video, preview, open-in). Pruning runs once at startup. Defaults to 2000 MB.

raw_decode_cache_enabled: bool

When true, decoded RAW textures are cached to disk for faster re-opens. Disable to save storage; each cached file is a full-resolution PNG.

raw_full_decode: bool

When true, RAW files are fully demosaiced from sensor data (slow but highest quality). When false the embedded camera JPEG preview is extracted instead (near-instant).

show_unnamed_faces: bool

Show people with no assigned name in the Explore view.

show_hidden_faces: bool

Include hidden people in the Explore view.

upload_xmp_sidecars: bool

Attach XMP sidecar files alongside media during upload. Per-folder rules can override this global default.

grid_border_width: f32

Border width between grid tiles in pixels (0.0 = edge-to-edge, max 10.0).

grid_border_color: String

Border color as a CSS hex string (e.g. “#ffffff”). Defaults to white.

Trait Implementations

impl Clone for ConfigData

fn clone(&self) -> ConfigData

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ConfigData

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ConfigData

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ConfigData

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ConfigData

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.