Deployer 9000 is a lightweight, CI/CD-ready deployment tool for GitHub Actions and other automation environments. Deploy your code via FTP, FTPS, SFTP, or SSH with simple configuration and secure best practices.

• 🚦 Deploys always: You won't see messages like "I'm sorry, Dave, I'm afraid I can't let you deploy that..." - Unlike his cousin HAL, DEP 9000 gets the job done!
• 🔌 Protocol Support: FTP, FTPS (with TLS), SFTP, SSH (rsync)
• 🤖 CI/CD Ready: Designed for seamless integration with GitHub Actions
• 🛡️ Secure by Default: Enforces SSL/TLS verification, supports SSH keys
• ⚙️ Highly Configurable: Control transfer options, parallel uploads, excludes, dry runs, pre/post scripts
• 📦 Minimal Dependencies: Alpine-based Docker image, single binary deployer

Go to your repository’s Settings > Secrets and variables > Actions and add at least:

• FTP_HOST — The FTP/SFTP/SSH server host or IP.
• FTP_USER — Login username.
• FTP_PASS — Login password (for FTP/SFTP) or leave empty if using SSH keys.

Add (or update) .github/workflows/deploy.yml in your repository with a minimal deploy step:

name: Deploy

on:
  push:
    branches: [ "main" ]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Code Deployment
        uses: Black-HOST/deployer@v1
        with:
          server: ${{ secrets.FTP_HOST }}
          username: ${{ secrets.FTP_USER }}
          password: ${{ secrets.FTP_PASS }}
          remote_dir: "/public_html"

For more advanced usage, see the .github/workflows/ folder in this repository.

This software is provided "as is" without warranty of any kind, express or implied. While it has been tested extensively, you should use it at your own risk.

Be especially cautious when using the delete: true option, as it will permanently remove files from your remote server that do not exist in your local directory. If you don't feel confident, always perform a dry_run: true first to verify which files will be deleted.

This project is maintained by Black HOST Ltd. and licensed under the MIT License.

See LICENSE file for more details.