Filesox

View Demo · Report Bug · Request Feature

About The Project

FileManager S3/Local is a versatile file manager that offers a flexible storage solution, enabling the use of Amazon S3 or local storage. Featuring an intuitive user interface and robust administration panel, it aims to simplify file management for businesses and developers.

Built With

• 
• 
• 

Getting Started

Prerequisites

• nodejs
• java 21

Installation

1. Clone the repo

   git clone https://github.com/TheoMeunier/filesox.git

2. Configuring the .env end front/.env file

3. Build front-end

    cd front
    npm install
    npm run build

4. Build back-end

    ./gradlew build

Docker

1. Create a docker-compose file

services:
  front:
    image: theomeunier/filesox-front:latest
    container_name: filemanager_front
    restart: unless-stopped
    ports:
      - "8888:80"
    environment:
      APP_API_URL: http://localhost:8080
    networks:
      - app_network

  back:
    image: theomeunier/filesox-back:latest
    container_name: filemanager_back
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./cache:/app/storages/cache
      - ./storage:/app/storages/uploads
      - ./.env:/app/.env
    depends_on:
      - mariadb
    networks:
      - app_network

  mariadb:
    image: mariadb:latest
    container_name: filemanager_db
    restart: unless-stopped
    ports:
      - "3306:3306"
    environment:
      MYSQL_DATABASE: filesox
      MYSQL_USER: filesox
      MYSQL_PASSWORD: filesox
      MYSQL_ROOT_PASSWORD: filesox
    volumes:
      - ./storage-db:/var/lib/mysql/
    networks:
      - app_network

networks:
  app_network:
    driver: bridge

Connect to the application

Your default admin credentials are:

• Email: admin@filesox.fr
• Password: adminadmin

It is strongly recommended that you change this password immediately after your first login for security reasons.

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.