File Server Application

A very simple File Server application written in Java.

Overview 📃

Actions supported:

• send multiple files and folders to server
• retrieve multiple files and folders from server
• delete multiple files and folders from server
• server can handle multiple client at the same time
• automatic encryption of each file sent to server
• automatic decryption of each file retrieved from server
• encryption is done with AES 256-bit key stored in a KeyStore (the KeyStore is locked with user password)

The application is only available in CLI.

Requirements 📄

• Java version 18 or higher installed on two machines (one will be the client and the other the server), you can check your java version with:

  java -version
  

• You need to know the local IP address of the machine that will act as the server and choose a port on which the server will listen (you will need these information to connect clients to the server).

Installation 🔌

If you don't want to build the project yourself, you can go to the release section and download the FileServer-1.0-SNAPSHOT.jar file.

Build the project 🔧

1. Download the repository files (project) from the green code button or clone the project with the following command:

   git clone https://github.com/vislower/FileServer.git
   

2. To compile, run the tests and package the project in a .jar file, go inside the project folder and run :
   • For UNIX systems:

      ./mvnw package
     

   • For Windows:

      mvnw.cmd package
     

3. Optionally you can install the packaged .jar file into your local maven repository by running:
   • For UNIX systems:

      ./mvnw clean install
     

   • For Windows:

      mvnw.cmd clean install
     

Run the application ✔️

1. Simply run the application with:

   java -jar FileServer-1.0-SNAPSHOT.jar
   

2. First run the serverside of the application on one machine. Then run the clientside of the application on another machine.
3. Follow the prompt.

Contributing 💡

If you want to contribute to this project and make it better with new ideas, your pull request is very welcomed. If you find any issue just put it in the repository issue section, thank you.

Thank You!

Please ⭐️ this repo and share it with others