Skip to main content

SFTP File Manager Access

The MangoGT comes with SSH enabled by default, which also enables SFTP (SSH File Transfer Protocol) access. SFTP provides a secure, encrypted method to transfer files between your local computer and the MangoGT. This is useful for uploading custom modules, transferring backup files, editing configuration files, and retrieving log files for analysis.

SFTP Client Software​

You will need an SFTP client on your computer. The following free clients are recommended:

  • FileZilla -- Available for Windows, macOS, and Linux. A popular, full-featured graphical SFTP client.
  • WinSCP -- Available for Windows. Provides a dual-pane file manager interface with drag-and-drop support.
  • Cyberduck -- Available for Windows and macOS. A lightweight client with a clean interface.
  • Command line -- macOS and Linux include the sftp command-line tool by default.

Connecting with FileZilla​

  1. Open FileZilla and go to File > Site Manager (or press Ctrl+S)
  2. Click New Site and configure the following settings:
SettingValue
ProtocolSFTP - SSH File Transfer Protocol
HostYour MangoGT's IP address or hostname (mangogtXXXX.local)
Port2222
Logon TypeNormal
Usermango
PasswordThe unique password from the sticker inside the MangoGT box
  1. Click Connect
  2. If this is your first connection, FileZilla will display a host key verification dialog. Click OK to trust the key and proceed.

Once connected, FileZilla displays a dual-pane interface with your local files on the left and the MangoGT file system on the right. You can drag and drop files between the two panes to transfer them.

Connecting with WinSCP​

  1. Open WinSCP and in the Login dialog, configure:
    • File protocol: SFTP
    • Host name: Your MangoGT IP or hostname
    • Port number: 2222
    • User name: mango
    • Password: The unique password from the sticker
  2. Click Login
  3. Accept the host key when prompted

Connecting from the Command Line​

On macOS or Linux, open a terminal and run:

sftp -P 2222 mango@mangogtXXXX.local

Replace XXXX with your MangoGT's serial number. Common SFTP commands:

# List remote files
ls

# Change remote directory
cd /opt/mango

# Download a file to your local machine
get ma.log

# Upload a file to the MangoGT
put my-module.zip

# Exit SFTP session
exit

MangoGT Directory Structure​

When connected via SFTP, you will land in the mango user's home directory. The key directories on the MangoGT are:

PathContents
/opt/mango/Mango installation root directory
/opt/mango/overrides/Configuration override files (properties, etc.)
/opt/mango/logs/Mango application log files
/opt/mango/backup/Local backup files
/opt/mango/filestore/File store data managed by Mango
/opt/mango/web/Web application files
/etc/network/Network configuration files
/etc/openvpn/OpenVPN configuration files

Common File Transfer Tasks​

Downloading Log Files​

Navigate to /opt/mango/logs/ in the remote pane and download ma.log or other log files to your local machine for analysis. This is particularly useful when troubleshooting issues that require sharing logs with Radix IoT support.

Uploading Module Files​

To manually install a Mango module, upload the module .zip file to /opt/mango/web/modules/ on the MangoGT, then restart the Mango service via SSH:

sudo service mango restart

Backing Up Configuration​

Download the contents of /opt/mango/overrides/ to preserve your custom configuration. This directory contains property override files that define your site-specific settings.

Security Notes​

  • SFTP uses the same SSH transport as the SSH connection, providing full encryption of file transfers and credentials.
  • The SFTP password is the Linux OS password (from the sticker inside the box), not the Mango web interface password.
  • File permissions on the MangoGT are configured so that the mango user can read and write files within the Mango installation directory. System files outside this directory require sudo access via SSH.
  • For automated file transfers (such as scripted backups), consider setting up SSH key-based authentication to avoid storing passwords in scripts.