# ProjectSend

> Self-hosted file sharing application.

- Category: Storage & Backup
- Difficulty: intermediate
- Components: projectsend, mariadb
- Tags: projectsend, sharing, clients, files
- Source: https://docker.recipes/storage/projectsend

## Overview

ProjectSend is a self-hosted file sharing application designed for professional client-file management scenarios where businesses need to securely distribute files to specific clients or groups. Originally developed as a PHP-based alternative to commercial file sharing services, ProjectSend emphasizes client management, permission controls, and branded file sharing portals that maintain professional appearance while providing detailed upload/download tracking and email notifications. This stack combines ProjectSend with MariaDB to provide a complete file sharing infrastructure where MariaDB handles user authentication, client management, file metadata, and activity logging while ProjectSend manages the web interface and file operations. The combination creates a robust client portal system that allows businesses to create individual client accounts, organize files by projects or groups, and maintain detailed audit trails of all file sharing activities. This setup is particularly valuable for creative agencies, consultants, legal firms, and any organization that needs to share confidential files with external clients while maintaining strict access controls and professional branding throughout the sharing experience.

## Features

- Client-based file sharing with individual user accounts and customizable access permissions
- Branded file sharing portal with custom logos and company information for professional client presentation
- Email notification system that alerts clients when new files are uploaded and notifies administrators of downloads
- Group management functionality allowing multiple clients to access shared project folders with role-based permissions
- File upload progress tracking with detailed logging of all client interactions and download history
- MariaDB-powered user authentication with encrypted password storage and session management
- Admin dashboard with comprehensive client management tools and detailed usage statistics
- File expiration controls allowing administrators to set automatic removal dates for sensitive documents

## Use cases

- Creative agencies distributing project deliverables, proofs, and final assets to clients with branded portals
- Legal firms sharing confidential documents with clients while maintaining detailed access audit trails
- Consulting companies providing project reports and documentation to multiple stakeholder groups
- Accounting firms distributing tax documents and financial reports to business clients during tax season
- Marketing agencies sharing campaign assets, brand guidelines, and promotional materials with client teams
- Software development companies delivering builds, documentation, and project artifacts to client organizations
- Architecture and engineering firms sharing blueprints, CAD files, and project documentation with contractors and clients

## Prerequisites

- Docker and Docker Compose installed with at least 1.5GB RAM available for MariaDB operations
- Port 80 available on the host system for ProjectSend web interface access
- Environment variables configured for DB_ROOT_PASSWORD and DB_PASSWORD with strong passwords
- Basic understanding of client-server file sharing concepts and user permission management
- SMTP server details available if email notifications for file sharing activities are required
- Domain name or static IP address for professional client access (recommended for production use)

## docker-compose.yml

```yaml
services:
  projectsend:
    image: lscr.io/linuxserver/projectsend:latest
    container_name: projectsend
    restart: unless-stopped
    environment:
      PUID: 1000
      PGID: 1000
      TZ: UTC
    volumes:
      - projectsend_config:/config
      - projectsend_data:/data
    ports:
      - "80:80"
    depends_on:
      - mariadb
    networks:
      - projectsend

  mariadb:
    image: mariadb:10.11
    container_name: projectsend-mariadb
    restart: unless-stopped
    environment:
      MARIADB_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
      MARIADB_DATABASE: projectsend
      MARIADB_USER: projectsend
      MARIADB_PASSWORD: ${DB_PASSWORD}
    volumes:
      - mariadb_data:/var/lib/mysql
    networks:
      - projectsend

volumes:
  projectsend_config:
  projectsend_data:
  mariadb_data:

networks:
  projectsend:
    driver: bridge
```

## .env

```bash
DB_ROOT_PASSWORD=rootpassword
DB_PASSWORD=projectsend
```

## Usage notes

- Docs: https://www.projectsend.org/documentation/
- Access at http://localhost - follow setup wizard (DB host: mariadb)
- Client-based sharing - create accounts for clients to access their files
- Email notifications when files uploaded/downloaded
- Group management for shared access
- Good for agencies sharing files with clients

## Troubleshooting

- Database connection failed during setup: Ensure MariaDB container is fully started by checking logs with 'docker logs projectsend-mariadb' before running ProjectSend setup wizard
- ProjectSend setup wizard shows database errors: Verify environment variables DB_PASSWORD matches between both containers and database name is exactly 'projectsend'
- File uploads failing or timing out: Increase PHP upload limits by mounting custom php.ini with higher upload_max_filesize and post_max_size values to ProjectSend container
- Email notifications not working: Configure SMTP settings in ProjectSend admin panel and verify firewall allows outbound connections on SMTP ports
- Client login issues after initial setup: Check MariaDB logs for authentication errors and ensure client accounts are properly created through ProjectSend admin interface
- Permission denied errors on file access: Verify PUID and PGID environment variables match the ownership of mounted volumes on the host system

