Skip to content

Commit d04f4ec

Browse files
committed
Update README
1 parent 709df92 commit d04f4ec

File tree

1 file changed

+95
-2
lines changed

1 file changed

+95
-2
lines changed

README.md

Lines changed: 95 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,95 @@
1-
# FTP-Move-Server-Files
2-
A simple bash script to move files over FTP / SSH from a source to a (different) destination server
1+
FTP Move Server Files
2+
=====================
3+
[![Issues][issues-shield]][issues-url]
4+
[![MIT License][license-shield]][license-url]
5+
6+
A simple bash script to move files over FTP / SSH from a source to a (different) destination server.
7+
8+
## Table of Contents
9+
10+
- [About the Project](#about-the-project)
11+
- [Getting Started](#getting-started)
12+
- [Pre-Requirements](#pre-requirements)
13+
- [Installation](#installation)
14+
- [Important Information](#important-information)
15+
- [Roadmap](#roadmap)
16+
- [Contributing](#contributing)
17+
- [License](#license)
18+
- [Contact](#contact)
19+
20+
21+
22+
## About The Project
23+
24+
**Current version**: 0.0.1 (Alpha Phase)
25+
26+
There are many cases where people want to transfer files and folders from a source server `A` to a destination server `B` (for example websites or backups). In most of the cases, the only possible solution to migrate a website to a new host is to download all files manually with a FTP client (like FileZilla) on your local computer and upload it to the new server afterwards. Direct transfers over FXP aren't possible in most of the cases due to restrictions in many (shared) webhosting packages. This small bash script will do the job for you!
27+
28+
If there is access to a VPS or Root Server `C`, I suggest executing the script on that machine to use the benefits of the data centre and to protect your own hardware and internet bandwidth.
29+
30+
31+
## Getting Started
32+
33+
### Pre-Requirements
34+
35+
To use the script, these are the only things you need:
36+
- Linux machine (or Mac or Winodws 10 with Linux Subsystem installed)
37+
- `ftp` installed (`sudo apt install ftp`)
38+
- `lftp` installed (`sudo apt install lftp`)
39+
40+
### Installation
41+
42+
1. Clone the repository and go into it
43+
```sh
44+
git clone https://github.com/mhellmeier/FTP-Move-Server-Files.git
45+
cd FTP-Move-Server-Files
46+
```
47+
2. Install requirements and set permissions if not already done or simple use the small install script
48+
```sh
49+
chmod +x install.sh
50+
sh install.sh
51+
```
52+
3. Start the transfer script and follow the instructions shown in your terminal
53+
```sh
54+
./moveServerFiles.sh
55+
```
56+
4. Enjoy!
57+
58+
### Important Information
59+
60+
- The script asks for passwords to connect to the source and destination hosts. Keep in mind that these will be used in the commands (plaintext!) to connect and download / upload content. It can be a security concern if the commands will be stored in the log history
61+
- To get rid of some certificate verifiaction errors, the scripts doesn't make certificate checks
62+
- Remember to open FTP / SSH relevant ports in your firewall
63+
- Use it at your own risk!
64+
65+
66+
## Roadmap
67+
68+
Alle planned features, bugs and discussions can be found in the [open issues](https://github.com/mhellmeier/FTP-Move-Server-Files/issues).
69+
70+
71+
## Contributing
72+
73+
Feel free to fork the project, work in your personal branch and create a pull request your simple interact in the [issue section](https://github.com/mhellmeier/FTP-Move-Server-Files/issues).
74+
75+
**This is an open source project! Every contribution is greatly appreciated!**
76+
77+
78+
## License
79+
80+
Distributed under the MIT License. See `LICENSE` for more information.
81+
82+
83+
## Contact
84+
85+
Malte Hellmeier - [![LinkedIn][linkedin-shield]][linkedin-url]
86+
87+
Project Link: [https://github.com/mhellmeier/FTP-Move-Server-Files](https://github.com/mhellmeier/FTP-Move-Server-Files)
88+
89+
90+
[issues-shield]: https://img.shields.io/github/issues/mhellmeier/FTP-Move-Server-Files.svg?style=flat-square
91+
[issues-url]: https://github.com/mhellmeier/FTP-Move-Server-Files/issues
92+
[license-shield]: https://img.shields.io/github/license/mhellmeier/FTP-Move-Server-Files.svg?style=flat-square
93+
[license-url]: https://github.com/mhellmeier/FTP-Move-Server-Files/blob/master/LICENSE
94+
[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=flat-square&logo=linkedin&colorB=555
95+
[linkedin-url]: https://linkedin.com/in/malte-hellmeier-91a64a17b/

0 commit comments

Comments
 (0)