holesail-file-system
v1.4.9
Published
A P2P based node package to expose your files access on the Holepunch protocol
Downloads
5
Maintainers
Readme
Holesail-file-system
Join our Discord Support Server
Overview
Holesail-file-system is a simple and flexible solution for creating a distributed hash table (DHT) server. It allows you to expose your local files system to the network, making it accessible to other nodes.
Installation
Before using holesail-file-system, make sure you have Node.js installed on your system. You can download Node.js from the official website: https://nodejs.org/en/download/
Once Node.js is installed, you can install Holesail-file-system Server using npm (Node Package Manager):
npm i holesail-file-system -g
Usage
To start a local Holesail-file-system Server, use the following command:
holesail-file-system --live port
Replace port
with the desired port number you want to expose to the network on which your file system will work.
This will give you a seed to connect to, use that to acess this server from anywhere:
holesail-file-system --connect SEED --port
Available options:
--live PORT
: Create a tunnel on this port
--connect SEED
: Connect to a tunnel using the seed generated from --live command
--host ADDRESS
: Default address is 127.0.0.1, use it to change address to localhost or other
--port PORT
: Use this option with --connect to set a custom port instead of the default port 8989
Example
To start a local holesail-file-system Server on port 8080, use the following command:
holesail-file-system --live 8080
Help
If you need help or want to see the usage instructions, use the following command:
holesail-file-system --help
Graceful Goodbye
Holesail-file-system Server includes graceful goodbye functionality, which ensures that the server is properly shut down when you close the terminal or interrupt the process.
License
Holesail-file-system Server is released under the GPL-3.0 License. See the LICENSE file for more information.
Contributing
Contributions are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request.
Acknowledgments
Holesail-file-system is built using the following open-source projects:
- hypertele: https://github.com/bitfinexcom/hypertele
- holepunch: https://holepunch.to
- holesail-server: https://github.com/holesail/holesail-server)
and other node packges.