Skip to content

Automate your FTP uploads effortlessly with ftp-uploader! This command-line tool seamlessly deploys your projects to shared hosting, integrating Gitignore logic for selective uploads. Say goodbye to manual hassles and hello to streamlined, time-efficient deployment.

License

Notifications You must be signed in to change notification settings

Ragueel/ftp-uploader

Repository files navigation

ftp-uploader

Release GitHub CI

Tired of the manual grind when it comes to uploading projects to a shared hosting with FTP access? Enter

ftp-uploader

a robust command-line tool engineered to simplify your workflow and automate the process of deploying projects to your FTP server.

Key Features:

  • Seamless Automation: Bid farewell to manual uploads. Effortlessly deploy your projects with a single command.
  • Selective Uploads: Tailor your uploads by leveraging Gitignore logic. Easily ignore specific paths and files, putting you in control of your project uploads.
  • Time-Efficient: Save precious time on repetitive FTP uploads, allowing you to concentrate on refining your projects.

Installation

Install the latest build

Linux

sudo curl -fsSL -o /usr/local/bin/ftp-uploader https://github.com/Ragueel/ftp-uploader/releases/latest/download/ftp-uploader-linux-amd64
sudo chmod +x /usr/local/bin/ftp-uploader

Docker

docker pull ghcr.io/ragueel/ftp-uploader:main

Creating config

Init project with:

ftp-uploader init

It should generate your ftp-uploader.yaml with the following content:

configs:
  default:
    root: . # local root directory, in which files you want to upload lie
    uploadRoot: my-relative-path/ # directory where files will be uploaded
    ignorePaths:
      - ftp-uploader.yaml

note: You can have as many configs as you want!

ignorePaths follows the same structure as ignore lines of any normal .gitignore file

You can also provide ignoreFile variable in the config. It will merge lines from the file with ignorePaths

You can configure the behaviour of the tool via the following environment variables

name description
FTP_UPLOADER_CONNECTION_COUNT controls how many parallel connections are created
ROOT_CONFIG_PATH path to your ftp-upload.yaml file
FTP_UPLOADER_USERNAME username
FTP_UPLOADER_PASSWORD password
FTP_UPLOADER_HOST host (port should be included)

Uploading to ftp server

If you set up everything properly, you can start your upload via the following command:

ftp-uploader upload -c default

If config is not passed it uploads all configs. Example:

ftp-uploader upload

You can also pass authentication credentials via terminal. Like in the example below

ftp-uploader upload --username MY_USER --pasword MY_PASSWORD --host MY_HOST --config example

It is also possible to use multiple connections to speed up the process of uploading. To do that pass -t flag with integer. The tool will create connections equal to that amount, and will use it to upload your files.

ftp-uploader upload -c default -t 10 # will use 10 connections to upload files

Get more info with

ftp-uploader -h

Note:

This tool was created to simplify the FTP uploading process for projects hosted on shared servers. Your feedback and contributions will make it even better!

About

Automate your FTP uploads effortlessly with ftp-uploader! This command-line tool seamlessly deploys your projects to shared hosting, integrating Gitignore logic for selective uploads. Say goodbye to manual hassles and hello to streamlined, time-efficient deployment.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages