# Installing FileMage Gateway on Microsoft Azure

FileMage Gateway, a SFTP and FTP server backed by Azure Blob Storage, is available on Microsoft Azure as a virtual machine (VM) image. The VM image contains a fully configured installation of FileMage Gateway ready to be used on Microsoft Azure.


When deploying a Linux image, SFTP is running on port 2222.

# Creating a Virtual Machine

We provide a virtual machine image of FileMage Gateway for Microsoft Azure. No installation is required. You just need to create a virtual machine from the Microsoft Azure Virtual Machines Marketplace. This virtual machine image is fully functional upon launch and requires no additional configuration to use. However, you may need to make certain changes depending on your specific use case.


To create a virtual machine, you must have permissions to access and manage a subscription or resource group in Azure.

# Accessing FileMage Gateway for the first time

After deploying the virtual machine make note of its IP address. The web portal will be available at https://<server-ip>/. A self-signed certificate is used, which you will have to accept to bypass the browser warning. See Encryption and Certificates for instructions on how to install a signed certificate.

When logging in to the web portal for the first time, you must prove your ownership of the virtual machine by connecting as a system administrator user. From there you will be able to create your initial application administrator account. Once you have created an account, refresh this page to login to the application web portal.

# Windows

  • Connect to your Windows virtual machine using RDP with the administrator username and password.
  • Open a command prompt, then run:
filemage.bat init
  • Enter a email address for the administrator account.
  • Enter a password for the administrator account.
  • Refresh the page, or click Done.

Azure - Connect to a Windows virtual machine

# Linux

  • Connect to your Linux virtual machine using SSH with the username and password or private key you specified when launching it.
  • Run the command:
sudo filemage init
  • Enter a email address for the administrator account.
  • Enter a password for the administrator account.
  • Refresh the page, or click Done.

Azure - Connect to a Linux virtual machine

# Default Ports

By default, the following ports are used. See Configuration Reference for information on how to change these ports.

Description Windows Linux
HTTP 80 80
HTTPS 443 443
SFTP 22 2222
FTP 21 21
FTP Passive 6000-6005 6000-6005


When HTTPS is enabled traffic on the HTTP port will be redirected to the HTTPS port.


To use SFTP in Linux on port 22 sshd must be reconfigured to use a different port.

# Increase Passive Mode FTP Port Range

By default, FileMage Gateway deployed on Azure Marketplace is configured to use ports 6000-6005 for passive mode FTP data connections. This port range may be to small in situations where multiple clients attempt to establish data connections at the same time, and may cause connecting clients to experience delays or be completely unable to connect when they request passive data transfers. The following explains how to enable a larger port range for passive mode FTP in FileMage Gateway installed on a Microsoft Azure.

# Add Virtual Machine Inbound Security Rules

  1. Log in to Microsoft Azure portal.

  2. Go to Virtual machines

    • Click the name of the virtual machine you want to configure.
    • Under Settings, click on Networking.
  3. Click the Add inbound port rule button.

  4. In the Add inbound security rule panel, specify the following settings:

    • Service. Keep the Custom value in the drop-down list.
    • Port ranges. Specify the following port range: 49152-65535.
    • Priority. This value determines the order in which firewall rules are applied. Rules with low priority are applied before rules with high priority. We recommend keeping the automatically assigned Priority value.
    • Name. Give the rule a recognizable name so you can tell it apart from others.
    • (Optional) Description. If desired, you can add the description to the rule.


You may use any port range, however 49152-65535 is the recommend standard port range.

  1. Click OK.

# Set Application FTP Passive Mode Port Range

  1. Add, or modify if already present, the following settings in the application configuration file:
ftp_data_port_start: 49152
ftp_data_port_end: 65535

FileMage Gatway is now configured to use a larger range of ports for passive mode FTP data connections.