Open Source

Image management system
for your project

Open-source, self-hosted, and fully customizable.
Automatic optimization, multi-tenant, and powerful APIs.

Multi-tenantArchitecture
WebPAuto-optimization
Docker5-min setup
MITOpen Source
File Harbor
File Harbor
↑ Upload
AC
Images
24 files

Main Features

Everything you need to manage images in a modern, secure, and scalable way.

Multi-tenant Architecture

Full isolation between clients with dedicated API key authentication for each tenant.

Automatic Optimization

WebP conversion, compression, and automatic EXIF removal for optimal performance.

On-demand Resize

Generate custom sizes on the fly via query parameters for any need.

Album System

Organize images in public or private albums with protected access and sharing.

Avatar Management

A dedicated avatar per user with automatic replacement of the previous one.

API Documentation

Integrated Swagger/OpenAPI for quick integration and always up-to-date documentation.

Self-hosting with Docker

Install in 5 minutes with Docker Compose. File Harbor is fully open-source and can be installed on any server.

1
Create the docker-compose.yml file
Copy the content on the right to your server
2
Customize the variables
Edit the credentials and parameters directly in the file
3
Start with Docker Compose
docker compose up -d and you're up and running
docker-compose.yml
services:
  fileharbor:
    container_name: fileharbor
    image: registry.gitlab.com/heyatomdev/fileharbor:2.1.3
    restart: unless-stopped
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgresql://user:pass@db:5432/fileharbor
      - APP_URL=https://yourdomain/api
      - API_KEY=your-api-key
      - CACHE_TTL=3600
      - APP_PORT=3000
      - LOGS_TOKEN=fileharbor
    volumes:
      - ./fileharbor/storage:/usr/src/app/storage
    depends_on:
      - db

  fileharbor-db:
    image: postgres:18.1
    container_name: fileharbor-db
    environment:
      - POSTGRES_USER=user
      - POSTGRES_PASSWORD=pass
      - POSTGRES_DB=fileharbor
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

Let us take care of the infrastructure

We offer managed File Harbor hosting tailored to your needs. Full setup, automatic backups, and priority support included.

  • Dedicated optimized server
  • Integrated global CDN
  • Daily automatic backups
  • Priority technical support
  • Automatic updates
  • Included SSL certificate
  • 24/7 monitoring
  • Guaranteed SLA

Note: Access to the hosted platform is reserved exclusively for administrators of already approved projects. Public registrations are not possible.

Request Hosting Access

Full Setup

Configuration and managed deployment by our team on optimized infrastructure.

Security & Backup

Daily automatic backups, SSL, and continuous security monitoring.

Personalized Support

Dedicated team for technical assistance, onboarding, and custom configuration.

Flexibility

Adaptable configurations that grow with your project, without rigid constraints.

Technology Stack

Built with modern technologies for performance, scalability, and developer experience.

Backend

  • NS
    NestJS 10
    Scalable and modular Node.js framework
  • PR
    Prisma ORM
    Type-safe database access layer
  • PG
    PostgreSQL
    Reliable relational database
  • TS
    TypeScript
    Static typing and IntelliSense

Features

  • RL
    Rate Limiting
    Built-in API protection against abuse
  • JQ
    Job Scheduling
    Background async optimization
  • SW
    Swagger/OpenAPI
    Integrated interactive documentation
  • MT
    Multi-tenant
    Full isolation between tenants

Get started with File Harbor

Choose the mode that best suits your project

Free

Free Self-Hosting

Install on your server in 5 minutes with Docker Compose. Full control of your data.

Read the documentation
On Request

Managed Hosting

Request access for your project. Managed infrastructure, automatic backups, and priority support.

Request Access