Get SFTP access to the Squad log

heliana reads Squad events by tailing SquadGame.log over SFTP, and, on servers with Config managed by heliana turned on, uses the same connection to write your whitelist to Admins.cfg.

What heliana needs

The 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)
SFTP username	SFTP account username
SFTP password	SFTP account password
Game server folder	Folder your Squad server is installed in — the one that contains SquadGame/

Caution

Reading the log needs only read access. The SFTP account needs write access if you turn on Config managed by heliana: heliana then pushes your whitelist to the server over this same connection, and a read-only account will let the log tail work while every write to Admins.cfg fails — the Config row in the channel list of the server’s header on the Dashboard shows the apply as failing, and hovering it gives the reason. With the switch off, heliana never writes the file.

Credentials

heliana logs in with a username and password only — key-based authentication is not supported. If the SFTP account has no password, set one before connecting.

Game server folder

Enter the folder that contains your Squad install — the one with SquadGame/ inside it, not SquadGame/ itself. heliana appends the paths to the log file and the whitelist file under SquadGame/ on its own, for example:

/home/squad/squad-server

See also

• Connect your first server
• Log parsing