# File Browser

> Web-based file manager with media preview.

- Category: Media & Entertainment
- Difficulty: beginner
- Components: filebrowser
- Tags: filebrowser, files, manager, web
- Source: https://docker.recipes/media/filebrowser

## Overview

File Browser is a modern, web-based file management application written in Go that transforms any server directory into a beautiful, feature-rich web interface. Originally created as a lightweight alternative to complex file management systems, it provides an intuitive way to browse, upload, download, and manage files through any web browser, complete with built-in media preview capabilities for images, videos, audio files, and documents. File Browser stands out for its simplicity and zero-dependency approach, requiring no complex setup or additional services to function effectively.

This Docker deployment creates a self-contained file management system that exposes your server's file system through a secure web interface on port 8080. File Browser handles all file operations internally, from basic CRUD operations to advanced features like public link sharing and command execution, while maintaining a persistent SQLite database to store user configurations, permissions, and sharing settings. The containerized approach ensures consistent behavior while keeping your host system clean and manageable.

This setup is ideal for home lab enthusiasts who need remote file access, small teams requiring collaborative file sharing, content creators managing media libraries, and system administrators who want to provide controlled file access to users without SSH privileges. File Browser's user management system allows you to create multiple accounts with scoped directory access, making it perfect for multi-tenant environments where different users need access to different portions of your file system.

## Features

- Built-in media preview for images, videos, audio files, and PDF documents without external plugins
- Multi-user support with granular directory-based permissions and access control
- Public link sharing with optional password protection and expiration dates
- Drag-and-drop file uploads with progress tracking and batch operations
- Command runner functionality to execute custom scripts on selected files
- Full-text search across filenames with filtering by file type and modification date
- Mobile-responsive interface optimized for smartphones and tablets
- Single binary deployment with embedded web assets and SQLite database storage

## Use cases

- Personal cloud storage replacement for accessing home files remotely via web browser
- Media server frontend for browsing and streaming video/audio collections with built-in previews
- Team file sharing hub for small businesses without complex enterprise solutions
- Photography workflow management with high-resolution image preview and organization
- Development project file access for remote teams working on shared codebases
- Educational institutions providing students controlled access to course materials and submission folders
- Content creation studios managing large media asset libraries with collaborative access

## Prerequisites

- Docker and Docker Compose installed with at least 512MB available RAM
- Port 8080 available and accessible from your network or internet if remote access needed
- Read/write permissions on the host directory you want to expose through File Browser
- Basic understanding of file permissions and user management concepts
- Web browser with JavaScript enabled for full interface functionality
- Consider firewall configuration if allowing external access beyond local network

## docker-compose.yml

```yaml
services:
  filebrowser:
    image: filebrowser/filebrowser:latest
    container_name: filebrowser
    restart: unless-stopped
    ports:
      - "8080:80"
    volumes:
      - /path/to/files:/srv
      - filebrowser_db:/database
    environment:
      FB_DATABASE: /database/filebrowser.db
      FB_ROOT: /srv
      FB_LOG: stdout
      FB_NOAUTH: "false"

volumes:
  filebrowser_db:
```

## .env

```bash
# Configure your files path
```

## Usage notes

- Docs: https://filebrowser.org/
- Access at http://localhost:8080 - default login: admin/admin
- Built-in viewers for images, video, audio, and documents
- Create users with scoped access to specific directories
- File upload, download, sharing via public links
- Command runner executes scripts on files (enable in settings)

## Troubleshooting

- Permission denied errors accessing files: Ensure the container has proper read/write permissions on the mounted volume path
- Default admin/admin login not working: Check container logs for database initialization errors and verify the database volume is properly mounted
- Files not appearing in web interface: Verify the FB_ROOT environment variable points to the correct internal container path (/srv)
- Upload failures for large files: Check available disk space on both host system and Docker volume storage location
- Command runner not executing scripts: Enable the feature in settings and ensure scripts have proper execute permissions on the host system
- Unable to access on port 8080: Verify no other services are using the port and check Docker port mapping configuration

