Page 1 of 1

MacOS configuration file

Posted: Thu Apr 17, 2025 12:04 am
by thaddeusf
Hello.

I'm sorry to create a new thread, but I'm finding conflicting information on configuring the MacOS with my account-token and machine-name. v7 seemed to have a utility. Linux has a straightforward configuration file. Can someone please send me a quick way to do this?

Thanks.

Re: MacOS configuration file

Posted: Thu Apr 17, 2025 12:44 am
by Joe_H
Normally you would enter it through the Web Control interface. But if you are talking about a headless Mac, you could use a config.xml file just like on Linux. Location of the file would normally be in /Library/Application Support/FAHClient. That is where the client installer would check for a v7 install and read that file. It also gets read at startup of the client.

Re: MacOS configuration file

Posted: Thu Apr 17, 2025 12:49 am
by thaddeusf
The web control doesn't give me an option for token or changing the machine name. It does let me put in a passphrase, but I need token.

Is the format of the config file the same as linux in the FAHClient folder?

Re: MacOS configuration file

Posted: Thu Apr 17, 2025 12:52 am
by calxalot
You normally login to your web control account, which handles any token for you.

The config.xml file is the same as Linux, if you want to do it that way.

Re: MacOS configuration file

Posted: Thu Apr 17, 2025 3:05 am
by thaddeusf
Using /Library/Application Support/FAHClient/config.xml worked like a champ. Thanks all!

Re: MacOS configuration file

Posted: Tue Apr 22, 2025 11:10 pm
by thaddeusf
Has anyone made a comprehensive config.xml variable list for v8.4.9? I started reading source on github, but I don't know where to go and it's talking a lot of time. When I'm searching for config.xml details there is a lot of v7 which seems completely different.

Thanks

Re: MacOS configuration file

Posted: Wed Apr 23, 2025 1:23 am
by calxalot
There is no guide I know of.
You can see options via

Code: Select all

fah-client --help
Many options are internal things that you should not mess with.
Anything exposed in web control is at best first-run only read from config.xml.

Re: MacOS configuration file

Posted: Wed Apr 23, 2025 1:33 am
by calxalot
Example bits from my config.xml

Code: Select all

<config>
  <log-domain v='true'/>
  <http-addresses v='0.0.0.0:7396'/>
  <allow v='127.0.0.1 10.0.0.0/8 192.168.0.0/16 172.16.0.0/12 169.254.0.0/16'/>

  <cause v='alzheimers'/>
  <team v='1971'/>
  <user v='calxalot'/>
</config>
Last 3 are first-run defaults.
You should probably instead use account-token to pre-configure account linking.
Note my allow list is not secure.

Re: MacOS configuration file

Posted: Fri Apr 25, 2025 3:37 pm
by thaddeusf
For thread... The v8.4.9 format of config.xml is somewhat different that v7. Here is what works:

On Linux: /etc/fah-client/config.xml
On Mac: /Library/Application Support/FAHClient/config.xml

<config>
<account-token v="asdfasdfasdfasdfasdfasdfasdfasdfasdfasdfasdfasdfas"/>
<machine-name v="XXXXXXXX"/>
<user v="Joe_Mouser"/>
<passkey v="12341234123412342134213412341234"/>
</config>

Thanks.

Re: MacOS configuration file

Posted: Fri Apr 25, 2025 9:30 pm
by calxalot
The format is the same.
The supported elements (options) has changed.