> ## Documentation Index
> Fetch the complete documentation index at: https://studio.bjanczak.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure FLEX Media Studio

Media Studio runs as a Laravel media library with an embeddable React interface.
Spatie Laravel Permission v8 is a required dependency. Filament, FLEX Fields,
Spatie Media Library v11 and a read-only tag mapping for external sources are optional integrations.

| Configure | Guide |
| - | - |
| Identity and access | [Authentication](https://studio.bjanczak.com/authentication.md), [members and permissions](https://studio.bjanczak.com/members.md), [tenancy](https://studio.bjanczak.com/tenancy.md) |
| Library and interface | [Workspace settings](https://studio.bjanczak.com/workspace-preferences.md), [embedding and branding](https://studio.bjanczak.com/embedding.md) |
| Storage and delivery | [Local storage](https://studio.bjanczak.com/storage-local.md), [private S3](https://studio.bjanczak.com/storage-s3.md), [CDN](https://studio.bjanczak.com/cdn-delivery.md), [encryption](https://studio.bjanczak.com/encryption.md) |
| Media lifecycle | [Upload options](https://studio.bjanczak.com/uploads.md), [processing configuration](https://studio.bjanczak.com/processing-configuration.md), [application references](https://studio.bjanczak.com/media-references.md) |
| Optional services | [Search](https://studio.bjanczak.com/search.md), [semantic search](https://studio.bjanczak.com/semantic-search.md), [assistant](https://studio.bjanczak.com/assistant.md), [Slack](https://studio.bjanczak.com/slack.md), [MCP](https://studio.bjanczak.com/mcp.md) |

## Complete settings inventory

Use the [configuration reference and capability matrix](https://studio.bjanczak.com/configuration-reference.md)
for all 344 shipped settings, default values, additional runtime overrides and
links to examples. Thumbnail generation is documented independently for
[images](https://studio.bjanczak.com/image-rendition-presets.md), [PDF/Office/text](https://studio.bjanczak.com/document-thumbnails.md),
[video](https://studio.bjanczak.com/video-thumbnails.md) and [application-owned files](https://studio.bjanczak.com/application-files-thumbnails.md).

## Workspace storage

Publish the configuration and migrations explicitly before creating workspaces.
Installing the provider does not automatically create tables or scan storage.

```php theme={null}
// config/media-studio.php
return [
    'workspace_creation' => true,
    'principals' => [
        'user' => App\Models\User::class,
        // 'employee' => App\Models\Employee::class,
    ],
    'storage' => [
        'disk' => 'local',
        'root' => 'media-studio',
    ],
];
```

Use the alias of the actual authenticated model. String, UUID and ULID user keys
are preserved. A workspace records its disk/root when it is created; changing the
default does not move existing files to another disk.

Storage remains private. A library card carries a stable asset ID and version ID;
applications should store these references rather than a temporary storage URL.

## Workspace availability and limits

[Continue to Workspace and viewer settings](https://studio.bjanczak.com/workspace-preferences.md#workspace-availability-and-limits).

## Language and timezone preferences

[Continue to Workspace and viewer settings](https://studio.bjanczak.com/workspace-preferences.md#language-and-timezone-preferences).

## Optional old-chat retention

[Continue to Assistant retention](https://studio.bjanczak.com/assistant-retention.md#optional-old-chat-retention).

## Notification inbox

[Continue to the dedicated guide](https://studio.bjanczak.com/notifications.md).

## Image thumbnails and workers

[Continue to Configure processing and workers](https://studio.bjanczak.com/processing-configuration.md#image-thumbnails-and-workers).

## Recover interrupted upload writes

[Continue to the dedicated guide](https://studio.bjanczak.com/upload-recovery.md).

## Store references in your own application

[Continue to Reference Studio media from your app](https://studio.bjanczak.com/media-references.md#store-references-in-your-own-application).

## Branding and embedding

[Continue to Embed and customize Studio](https://studio.bjanczak.com/embedding.md#branding-and-embedding).

## Optional integrations

* [Configure file and folder transfers, chunks and direct S3 multipart](https://studio.bjanczak.com/uploads.md).

* [Connect Media Studio to Filament editors](https://studio.bjanczak.com/filament-editors.md).

* [Browse files and conversions from an existing Spatie Media Library](https://studio.bjanczak.com/spatie-media-library.md).

* [Create native image conversions or reuse existing thumbnail systems](https://studio.bjanczak.com/image-conversions.md).

* [Organize files with favorites, recent items and bulk actions](https://studio.bjanczak.com/library-organization.md).

* [Configure filters and custom sorters](https://studio.bjanczak.com/filters-and-sorting.md).

* [Use optional native Filament actions](https://studio.bjanczak.com/filament-actions.md).

* [Configure tenant isolation](https://studio.bjanczak.com/tenancy.md).

## Settings and workspace permissions

[Continue to Workspace and viewer settings](https://studio.bjanczak.com/workspace-preferences.md#settings-and-workspace-permissions).

## Restore a library view from its URL

[Continue to Workspace and viewer settings](https://studio.bjanczak.com/workspace-preferences.md#restore-a-library-view-from-its-url).

## Workspace member profiles

[Continue to Workspace and viewer settings](https://studio.bjanczak.com/workspace-preferences.md#workspace-member-profiles).

### Member permissions and Redis

[Continue to Workspace and viewer settings](https://studio.bjanczak.com/workspace-preferences.md#member-permissions-and-redis).

## Preview action bar

[Continue to Embed and customize Studio](https://studio.bjanczak.com/embedding.md#preview-action-bar).

## Optional AI client connections

The **AI** navigation item and optional Laravel MCP server are documented in
[MCP connections](https://studio.bjanczak.com/mcp.md). The server is disabled by default and has its own
Spatie permissions. It does not require Filament or enable image analysis.

## Configure navigation and page panels

[Continue to Embed and customize Studio](https://studio.bjanczak.com/embedding.md#configure-navigation-and-page-panels).

## Document previews

[Continue to Embed and customize Studio](https://studio.bjanczak.com/embedding.md#document-previews).

## Primary color and viewer profile

[Continue to Embed and customize Studio](https://studio.bjanczak.com/embedding.md#primary-color-and-viewer-profile).

## Authentication: host model, Filament and standalone installation

[Continue to Host and standalone authentication](https://studio.bjanczak.com/authentication.md#authentication-host-model-filament-and-standalone-installation).

## Optional encryption policy

`encryption.mode` defaults to `off`. Select native infrastructure policies, portable application file encryption (currently experimental), or a hybrid setup. Named-disk policies can inherit provider defaults or request SSE-S3/SSE-KMS/DSSE-KMS. Volume/database protection remains an explicit deployment responsibility. See [encryption configuration](https://studio.bjanczak.com/encryption.md) for supported scope and examples.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.