Get SFTP access to the Squad log

heliana reads Squad events by tailing SquadGame.log over SFTP, and uses the same connection to write your whitelist to Admins.cfg. This page explains how to obtain SFTP credentials from your server host and what to enter in the connection form.

What heliana needs

The Log source (SFTP) section of the server form requires:

Field	Description
SFTP host	IP or hostname of your host’s SFTP server
SFTP port	SSH/SFTP port (almost always 22)
Username	SFTP account username
Password / Key	SFTP account password
Game server path	Folder your Squad server is installed in

The SFTP account needs write access, not just read — heliana uses it to push your whitelist to the server as well as to read the log.

Find your credentials

SFTP credentials are provided by your server host, not by Squad itself. The exact steps differ per provider, but the pattern is consistent:

1. Log in to your hosting control panel (e.g. GameServerKings, GTX Gaming, Nitrado, or a self-managed VPS).
2. Locate the SFTP / File Manager or FTP Access section for your game server instance.
3. Note the host, port, username, and password shown there. Some panels let you set or reset the SFTP password if you have not used it before.
4. Confirm the account has write permission on the server’s files, not just read-only browsing — heliana needs to write the whitelist file. If your panel offers a read-only SFTP account alongside a full-access one, use the full-access account.

heliana authenticates to SFTP with a username and password. Key-based authentication is not supported, so make sure your host’s panel has a password set for the account.

Tip

If your host does not expose a separate SFTP panel, look in the server’s general settings for “FTP access” or “file access”. SSH/SFTP on port 22 is standard; some shared-hosting providers use a non-standard port shown in their panel.

Find the game server path

heliana needs the folder your Squad server is installed in — the folder that contains Saved/ and ServerConfig/. It finds the log file and writes the whitelist file under this path on its own; you don’t need to enter either of those paths yourself.

The default install path looks like:

/squad/SquadGame

Your host may install Squad under a different root, such as /home/user/squad/SquadGame or /servers/squad1/SquadGame. If you are unsure:

1. Connect to your server over SFTP with a client like FileZilla.
2. Navigate to the Squad installation folder and confirm it contains a Saved folder and a ServerConfig folder.
3. Copy that folder’s full path and paste it into the Game server path field in heliana.

See also

• Connect a server
• Log parsing