<%!-- Header Section --%>

<%!-- Back Button (Left aligned) --%> <.link navigate={PhoenixKit.Utils.Routes.path("/admin/modules")} class="btn btn-outline mb-4" > <.icon name="hero-arrow-left" class="w-4 h-4 mr-2" /> Back to Modules <%!-- Title Section --%>

Storage Settings

Configure storage buckets and file processing settings for your application

<%!-- Module Status Alert --%>

<.icon name="hero-information-circle" class="w-5 h-5" />

Core System Module

Storage is a core system module that is always enabled and cannot be disabled. It provides essential file management functionality across PhoenixKit.

<%!-- System Dependencies Check --%> <%= if match?({:error, :not_installed}, @imagemagick_status) do %>

<.icon name="hero-exclamation-circle" class="w-5 h-5" />

ImageMagick Not Installed

ImageMagick is required for image processing and variant generation. Without it, image resizing, cropping, and format conversion will not work.

Installation:
macOS: brew install imagemagick
Ubuntu/Debian: sudo apt-get install imagemagick
CentOS/RHEL: sudo yum install ImageMagick

<% end %> <%= if match?({:error, :not_installed}, @ffmpeg_status) do %>

<.icon name="hero-exclamation-triangle" class="w-5 h-5" />

FFmpeg Not Installed

FFmpeg is required for video processing, transcoding, and thumbnail generation. Without it, video file processing will not work.

Installation:
macOS: brew install ffmpeg
Ubuntu/Debian: sudo apt-get install ffmpeg
CentOS/RHEL: sudo yum install ffmpeg

<% end %> <%!-- Storage Buckets --%>

<.icon name="hero-inbox-stack" class="w-6 h-6 mr-2" /> Storage Buckets

<.link navigate={PhoenixKit.Utils.Routes.path("/admin/settings/media/buckets/new")} class="btn btn-primary" > <.icon name="hero-plus" class="w-4 h-4 mr-1" /> Add Bucket

<%= if Enum.empty?(@buckets) do %>

<.icon name="hero-exclamation-triangle" class="w-5 h-5" />

No Storage Buckets Configured

You need to create at least one storage bucket before files can be uploaded. Buckets can be local directories or cloud storage providers (AWS S3, Backblaze B2, Cloudflare R2).

<.link navigate={PhoenixKit.Utils.Routes.path("/admin/settings/media/buckets/new")} class="btn btn-warning btn-sm" > <.icon name="hero-plus" class="w-4 h-4 mr-1" /> Create Your First Bucket

<% else %>

<%= for bucket <- @buckets do %> <%!-- Name --%> <%!-- Provider --%> <%!-- Priority --%> <%!-- Files Count --%> <%!-- Status --%> <%!-- Actions --%> <% end %>

Name	Provider	Priority	Files	Status	Actions
<%= case bucket.provider do %> <% "local" -> %> <.icon name="hero-folder" class="w-5 h-5 text-primary" /> <% "s3" -> %> <.icon name="hero-cloud" class="w-5 h-5 text-warning" /> <% "b2" -> %> <.icon name="hero-cube" class="w-5 h-5 text-info" /> <% "r2" -> %> <.icon name="hero-cloud-arrow-up" class="w-5 h-5 text-accent" /> <% _ -> %> <.icon name="hero-server" class="w-5 h-5 text-base-content/50" /> <% end %> {bucket.name} {get_bucket_full_path(bucket)}	{String.upcase(bucket.provider)}	<%= if bucket.priority == 0 do %> Random (0) <% else %> {bucket.priority} <% end %>	{Map.get(@bucket_file_counts, bucket.id, 0)} files	<%= if bucket.enabled do %> Enabled <% else %> Disabled <% end %>	<%!-- Edit Button --%> <.link navigate={ PhoenixKit.Utils.Routes.path( "/admin/settings/media/buckets/#{bucket.id}/edit" ) } class="btn btn-xs btn-ghost" title="Edit bucket" > <.icon name="hero-pencil" class="w-4 h-4" /> <%!-- Toggle Enable/Disable --%> <%!-- Delete Button --%>

Total Buckets

{length(@buckets)}

Configured storage locations

Active Buckets

{Enum.count(@buckets, & &1.enabled)}

Currently in use

Default Bucket

<%= if @default_bucket_id do %> Set <% else %> None <% end %>

Primary storage location

<% end %>

<%!-- Storage Configuration --%>

<.icon name="hero-cog-6-tooth" class="w-6 h-6 mr-2" /> Storage Configuration

<.form for={%{"form_redundancy" => @form_redundancy}} phx-change="update_storage_form" class="grid grid-cols-1 md:grid-cols-2 gap-6" > <%!-- Redundancy Settings --%>

Redundancy Copies Number of copies to store <%= if @active_buckets_count == 0 do %>

<.icon name="hero-exclamation-triangle" class="w-4 h-4" /> No active buckets available. Enable buckets to configure redundancy.

<% else %> <%= if @form_redundancy > @max_redundancy do %>

<.icon name="hero-exclamation-triangle" class="w-4 h-4" /> Current setting (#{@form_redundancy} copies) exceeds available buckets (#{@max_redundancy}). Reduce redundancy or enable more buckets.

<% end %> @max_redundancy, do: "input-warning", else: ""}"} /> Enter number of copies (1-#{@max_redundancy}). <%= if @max_redundancy == 1 do %> Only 1 active bucket available. Add more buckets to enable redundancy. <% else %> Maximum #{@max_redundancy} copies based on #{@active_buckets_count} active bucket(s). <% end %> <% end %>

<%!-- Auto-Variant Generation --%>

Auto-Generate Variants Automatically resize images and videos to configured dimensions

<%!-- Apply Button --%>

<%= if @form_redundancy == @redundancy_copies and @form_auto_generate_variants == @auto_generate_variants do %> No changes to apply <% else %> Changes will be saved immediately <% end %>

<%!-- Quick Actions --%>

Quick Actions

<.link navigate={PhoenixKit.Utils.Routes.path("/admin/settings/media/dimensions")} class="btn btn-outline" > <.icon name="hero-photo" class="w-4 h-4 mr-2" /> Manage Dimensions

<%!-- Coming Soon Features --%>

<.icon name="hero-rocket-launch" class="w-6 h-6 mr-2" /> Advanced Features Coming Soon

<%!-- Multi-Location Storage --%>

🗂️

Multi-Location Storage

Store files across 1-5 redundant locations with automatic failover

<%!-- S3 Integration --%>

☁️

AWS S3 Integration

Store files in Amazon S3 buckets for cloud redundancy

<%!-- Remote Servers --%>

🖥️

Remote Servers

Distribute files across multiple remote servers and datacenters

<%!-- Admin Dashboard --%>

📊

Admin Dashboard

Monitor storage health, locations, and file distribution

<%!-- File Tracking --%>

📋

File Tracking

PostgreSQL-based file registry with location tracking

<%!-- Automatic Failover --%>

🔄

Automatic Failover

Seamless file retrieval even when storage locations fail

<%!-- Upload Test Section --%> <%!-- Help Section --%>

<.icon name="hero-light-bulb" class="w-5 h-5" />

Storage System Architecture

The storage system is designed for distributed file management with automatic redundancy. Files are tracked in PostgreSQL with support for multiple storage locations (local, S3, remote servers). When a file is requested, the system automatically tries each location until it successfully retrieves the file.