Awesome
<h2 align="center"> <p align="center"><img width=30% src="./.github/img/logo.png"></p> </h2> <p align="center"> <img alt="GitHub Build Status" src="https://img.shields.io/github/actions/workflow/status/kha7iq/ncp/build.yml?label=Build"> <a href="https://github.com/kha7iq/ncp/releases"> <img alt="Release" src="https://img.shields.io/github/v/release/kha7iq/ncp?label=Release"> <a href="https://goreportcard.com/report/github.com/kha7iq/ncp"> <img alt="Go Report Card" src="https://goreportcard.com/badge/github.com/kha7iq/ncp"> <a href="#"> <a href="https://github.com/agarrharr/awesome-cli-apps#file-syncsharing"> <img alt="Awesome" src="https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg"> <a href="https://github.com/kha7iq/ncp/issues"> <img alt="GitHub issues" src="https://img.shields.io/github/issues/kha7iq/ncp?style=flat-square&logo=github&logoColor=white"> <a href="https://github.com/kha7iq/ncp/blob/master/LICENSE"> <img alt="License" src="https://img.shields.io/github/license/kha7iq/ncp"> </p> <p align="center"> <a href="https://ncp.lmno.pk">Documentation</a> • <a href="#installation">Installation</a> • <a href="#features">Features</a> • <a href="#usage">Usage</a> • <a href="#contributing">Contributing</a> • </p>NCP (NFS Copy)
NCP offers a user-friendly solution for efficiently transferring files and folders between your local machine and the NFS server without mounting the volume. It enables seamless recursive upload and download operations, supporting both NFS v3 and NFS V4 protocols.
Features
- :sparkles: Support for NFS v3 and NFS v4
- Easy file transfer to and from an NFS server without mounting volume.
- Multi-architecture binaries available for installation (e.g deb, apk, rpm, exe)
- Compatible with Windows and macOS operating systems
- Option to specify UID and GID for write operations using a global flag
- Display upload and download speeds, file size and elapsed time for write operations.
- Copy a Single file or recursively copy an Entire folder.
Installation
<details> <summary>Linux</summary># DEB
export NCP_VERSION="0.1.1"
wget -q https://github.com/kha7iq/ncp/releases/download/v${NCP_VERSION}/ncp_amd64.deb
sudo dpkg -i ncp_amd64.deb
# RPM
sudo rpm -i ncp_amd64.rpm
- AUR
yay -S ncp-bin
pamac install ncp-bin
</details>
<details>
<summary>Windows</summary>
- Chocolatey
choco install ncp
- Scoop
scoop bucket add ncp https://github.com/kha7iq/scoop-bucket.git
scoop install ncp
</details>
<details>
<summary>Bash Install Script</summary>
By default, ncp is going to be installed at /usr/bin/
. Sudo privileges are required for this operation.
If you would like to provide a custom install path, you can do so as an input to the script.
For example, you can run ./install.sh $HOME/bin
to install ncp in the specified directory.
curl -s https://raw.githubusercontent.com/kha7iq/ncp/master/install.sh | sudo sh
or
curl -sL https://bit.ly/installncp | sudo sh
</details>
<details>
<summary>MacOS</summary>
brew install kha7iq/tap/ncp
</details>
<details>
<summary>Manual</summary>
# Chose desired version
export NCP_VERSION="0.1.1"
wget -q https://github.com/kha7iq/ncp/releases/download/v${NCP_VERSION}/ncp_linux_amd64.tar.gz && \
tar -xf ncp_linux_amd64.tar.gz && \
chmod +x ncp && \
sudo mv ncp /usr/local/bin/.
</details>
Alternatively you can head over to release pages and download binaries for all supported platforms.
Docker
Docker container is also available on both dockerhub and github container registry.
latest
tag will always pull the latest version available.
docker pull khaliq/ncp:latest
docker pull ghcr.io/kha7iq/ncp:latest
- Run
docker run khaliq/ncp:latest
</details>
Usage
Copying Files/Folders to NFS Server
To copy the _local/src
folder to the NFS server with the IP address 192.168.0.80
and the NFS path data
, use the following command:
- NFS v3
ncp to --input _local/src --nfspath data --host 192.168.0.80
- NFS v4
ncp v4to --input _local/src --nfspath data --host 192.168.0.80
See Usage Documentation for more details
Contributing
Contributions, issues and feature requests are welcome!<br/>Feel free to check issues page. You can also take a look at the contributing guide.
Issues
If you encounter any problems or have suggestions for improvements, please open an issue on GitHub.
License
NCP is licensed under the MIT License. Please note that it may use third-party libraries that have their own separate licenses. Refer to the individual licenses of those libraries for more information.