Troubleshooting - rejetto/hfs GitHub Wiki

General

I often get logged out and have to log in again

It's likely that your IP is changing. By default, HFS invalidates your session when the IP changes, to prevent some type of attacks. It's not a necessary thing and you can decide to disable it. There's no option in the Admin-panel for now, you'll have to edit your config.yaml and add this line

allow_session_ip_change: true

HFS is closed and I can't see any error

  1. First, check if the error can be found in file debug.log.
  2. If it doesn't, download and unzip this file (Windows-only) called hfs-pause: it will run hfs and pause just before closing, giving you the chance to read.

EPERM errors at start running HFS from "C:\program files"

hfs.exe is not designed to be run from inside "program files", so best thing is to move outside of it. This happens because for legacy reasons, hfs.exe by default stores data inside the same folder, that is not permitted by Windows under "program files".

No public IP address / Double NAT

Some internet providers don't give you a public address. Without it, HFS cannot serve over the internet. If you need to, your options are

  • Ask your internet provider if they sell "public IP" as an extra service
  • Use a relay service. This mean that your traffic will be relayed through another server, so you will be subject to its limitations. Here are some of these services