Skip to main content

Installation

Download​

To start using FastTransfer, first request a trial or purchase a license to download the latest version (0.14.1).

Once downloaded, unzip FastTransfer to a directory of your choice.

Expand-Archive -Path .\FastTransfer.zip -DestinationPath .\FastTransfer

On Linux, you need to give execution rights to the FastTransfer binary:

chmod +x FastTransfer

You can verify the installation by checking the version:

.\FastTransfer.exe --version

You are now ready to run FastTransfer.

License File​

FastTransfer requires a license file to operate.

License Information

After the trial period, you will need a valid license. By default, FastTransfer will try to find a FastTransfer.lic file in the same directory as the executable. You can also provide another path, a URL, or even the license content using the --license parameter.

License File Location Options​

Option 1: Default Location (Recommended)

Place the FastTransfer.lic file in the same directory as the FastTransfer executable:

C:\Tools\FastTransfer\
├── FastTransfer.exe
└── FastTransfer.lic

Option 2: Custom Path

Specify the license file path using the --license parameter:

./FastTransfer \
  --license "/path/to/FastTransfer.lic" \
  ...

Option 3: License Content

Pass the license content directly (useful for CI/CD):

./FastTransfer \
  --license "LICENSE_CONTENT_STRING_HERE" \
  ...

Option 4: URL

Load the license from a URL:

./FastTransfer \
  --license "https://example.com/licenses/FastTransfer.lic" \
  ...

Embedded Drivers​

The following database drivers are embedded in FastTransfer:

DatabaseEmbedded Drivers
ClickHouse
DuckDB
MS SQL Server
MySQL
Netezza
Oracle
PostgreSQL
SAP HANA
Teradata
ODBC/OLEDB Connections

If you need to connect to a database not in the embedded list, you can use ODBC or OLEDB connection types, but you will need to install the appropriate ODBC or OLEDB drivers for your database system separately.

System Requirements​

Operating Systems​

FastTransfer supports multiple operating systems and architectures. See Operating Systems Compatibility for the complete list.

Supported Platforms:

  • Windows (x64, ARM64)
  • Linux (x64, ARM64)
    • Ubuntu, Debian, RHEL, CentOS, Fedora, Alpine, and more
  • Windows Server (various versions)

Hardware Requirements​

Minimum:

  • CPU: 2 cores
  • RAM: 2 GB
  • Disk: 500 MB for installation
  • Network: Connectivity to source and target databases

Recommended for Large Transfers:

  • CPU: 4+ cores (benefits from parallelization)
  • RAM: 8+ GB
  • Disk: SSD for better I/O performance
  • Network: Low latency, high bandwidth connection to databases

Quick Start​

After installation, run your first transfer:

./FastTransfer \
  --sourceconnectiontype pgsql \
  --sourceserver "source.example.com" \
  --sourcedatabase "mydb" \
  --sourcetable "customers" \
  --targetconnectiontype mssql \
  --targetserver "target.example.com" \
  --targetdatabase "warehouse" \
  --targettable "customers"

See Getting Started for a detailed walkthrough.

Troubleshooting Installation​

Linux: Permission Denied​

If you get "Permission denied" when running FastTransfer:

chmod +x FastTransfer

License File Not Found​

If FastTransfer reports it cannot find the license file:

  1. Verify FastTransfer.lic is in the same directory as the executable
  2. Check file permissions (must be readable)
  3. Use the --license parameter to specify the path explicitly

Missing Dependencies (Linux)​

On some minimal Linux distributions, you may need to install additional libraries:

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install libicu-dev

# RHEL/CentOS
sudo yum install libicu

Firewall and Network​

Ensure your firewall allows outbound connections to your database servers on the required ports:

  • SQL Server: 1433
  • PostgreSQL: 5432
  • MySQL: 3306
  • Oracle: 1521
  • And others specific to your database

Next Steps​

Copyright © 2026 Architecture & Performance. Built with Docusaurus.