FOG Client is a cross platform computer management software. With it, Linux, Mac, and Windows machines can easily be managed by a remote server.

Windows	Linux	OSX
	[![Linux] (https://travis-ci.org/FOGProject/fog-client.svg?branch=master)] (https://travis-ci.org/FOGProject/fog-client/)	[![OSX] (https://travis-ci.org/FOGProject/fog-client.svg?branch=osx-build)] (https://travis-ci.org/FOGProject/fog-client/)

To build the entire client (including the Installer) Windows is required. This is due to the MSI for network deployment and the Universal Installer. The following dependencies must be installed and included in PATH

• WiX Toolset
• Powershell
• .NET v4.6
• MSBuild Tools 2015 (Included with Visual Studios 2015)

Powershell must be configured to allow scripts to be run on the machine. Open CMD as adminstrator and run

powershell "Set-ExecutionPolicy RemoteSigned"

powershell "C:\path\to\fog-client\build.ps1"

The binaries will be in C:\path\to\fog-client\bin

The client's functionality derives from modules. Each module has 1 specific goal, and is isolated from every other module. Each module is executed in a sandbox-like environment, preventing bad code from crashing the service. Since each module is isolated, the client's server can choose which modules to enable or disable.

AutoLogOut is responsible for automatically logging out users after a set inactivity period. Once that time period is reached, the user is notified that if they remain inactive they will be logged out.

• On Linux AutoLogOut is only possible if xprintidle is installed.
• On Windows one user must be logged in for other users to log out. This is a security measure put in place by Windows. For example, if 5 users are 'logged in', but all hit the 'Switch User' button, non will be logged out. But once someone logs into the machine they will be. GPO is recommened to handle auto log outs on Windows because of this restriction.

GreenFOG is a cron-style power management module. A computer can be configured to restart / shutdown at specific times / days. If automatic shutdown is used, GreenFOG cannot be used to turn back on the computer. Wake On Lan would need to be used to automate this.

HostnameChanger is one of the core, and most used, modules of the client. It will:

• Rename a computer
• Join a domain
• Leave a domain
• Activate a windows installation with a product key

This module also handles renaming in a domain-friendly fashion. If a computer is joined to a domain, it will first leave the domain, then rename the host, and then join back. This ensures that there are no remenants in the domain.

PrinterManager is aimed to replace the difficult GPO printer systems. Due to the complexity of printers in general, this module has one of the steepest learning curves.

There are three printer management modes

1. None No printers will be added or removed, this is identical to disabling the module
2. FOG Managed Printers The module will only remove printers from a computer if FOG is set to manage it. For example, if a person has personal printer attached to their computer, this module will not touch it.
3. Only Assigned Printers This mode should be used with caution. If selected, this module will only allow assigned printers to be added to a computer. For example, if a person has a personal printer, this module will prevent the user from adding it, unless a FOG administrator adds the printer to the list of managed.

Snapins are executables push out via the FOG server. A snapin can also be set to reboot after finishing. With this module you can push out MSIs, EXEs, batch scripts, shell scripts, or any other file capable of being executed.

TaskReboot will automatically restart a computer if the client's server has task waiting for the computer. Example tasks include image deployment, image capturing and hardware inventory.

UserTracker will automatically report to the FOG server any logins or logouts that occur on the computer.