# Settings

Exivity allows you to configure a number of system variables easily, such as:

* custom logo, branding and color schema
* currency and decimal values
* date format
* fiscal year
* custom css

To change these and other settings, follow the instructions provided in this document.

## Branding

To apply custom branding to the **Glass** interface, use the '*Administration*' > *Settings*' menu, and then select the '*Branding*' tab:

![configuration\_branding](https://3540922554-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHEKskLK6aXinV75Knl%2F-LHF0G1lYWN8xZtENgii%2F-LHF0MtdlVbwmFWtYvCI%2Fconfiguration-branding.png?generation=1531424651460279\&alt=media)

The following GUI adjustments can be done:

1. Provide your custom product name
2. Change the logo as show at the left top part of the screen. The rectangular logo that says "Exivity" by default
3. Change the square logo at the top left part of the screen. Next to the brand logo that says "Exivity" by default
4. Change the favicon as shown in your browser favorites bar
5. Change the GUI default color using the drop down list.
6. If you want to change other colors, font types and other CSS specific parts of the GUI that are not listed in this menu, you can use the '*Show Advanced*' button, to add custom CSS code
7. Click the *'Save'* button to apply your changes/

## Formatting

To change country specific formatting or decimal rounding, use the '*Administration*' > '*Configuration*' menu, and select the '*Branding*' tab:

![change configuration formatting](https://3540922554-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHEKskLK6aXinV75Knl%2F-LHF0G1lYWN8xZtENgii%2F-LHF0MthXm2E1pJ2c4s2%2Fchange-configuration-formatting.png?generation=1531424650135280\&alt=media)

The following changes to the formatting can be done:

1. Change the system wide *Currency* settings
2. Configure comma or dot value for the decimal separator
3. If you want to configure a thousands separator, you can choose between comma, dot and space
4. ***Rate precision*** refers to the amount of decimal values shown on reports for the (average) rate value
5. The ***Report precision*** can be changed to limit the number of decimal values shown on non-invoice reports
6. The ***Invoice precision*** can be changed to limit the number of decimal values shown on invoice cost reports
7. The quantity decimal values can be limited using ***Quantity precision***
8. To apply a system wide date format, choose your preferred date format from the ***Date format***  drop down list

## Reporting

To change reporting settings, such as the address lines and logo on your invoice report, use the '*Administration*' > '*Settings*' menu, and select the '*Reporting*' tab:

![change configuration reporting](https://3540922554-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHEKskLK6aXinV75Knl%2F-LHF0G1lYWN8xZtENgii%2F-LHF0MtlU0R7wNgxV4nN%2Fchange-configuration-reporting.png?generation=1531424650677350\&alt=media)

The following changes to the reporting configuration can be done:

1. Use the ***Address lines*** text field to provide a custom address which will be shown on the textual invoice cost reports
2. To change the ***Logo*** that will be shown on the right hand side of your invoice cost report, use *Select File* to browse and select your custom logo
3. A custom footer text can be added to your invoice report using the text field next to ***Extra text***
4. To adjust the maximum amount of series shown in the Exivity graphical report line graphs, change the value for ***Maximum graph series***
5. If you have a non-standard fiscal year start, you may change the ***Reporting start*** month using the provided drop down list
6. Use the ***Save*** button to apply your changes

## Privacy

Exivity can periodically report anonymous usage statistics and error metrics to improve our product. This is only used for product development purposes, we never collect or use any personal data.

This change this, use the **Administration > Settings** menu, and select the **Reporting** tab.

![](https://3540922554-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHEKskLK6aXinV75Knl%2F-MUraUgHHG-5lfX2QhO7%2F-MUrgPsQOSVW8MffI1rs%2Fimage.png?alt=media\&token=98eb1752-1368-4325-8a9f-e441a15ce95f)

Untick these checkboxes and click the **Update** button to opt-out on usage statistics and error metrics reporting.

Refer to our [Terms & Conditions](https://olddocs.exivity.io/3.4.3/terms-and-conditions) and [Privacy Policy](https://olddocs.exivity.io/3.4.3/privacy-policy) to read more about how we process usage statistics and error metrics.

## Mail server

Exivity is able to send out e-mail messages for certain tasks. This can be used for resetting user account passwords and sending out events such as failing workflows. To enable this functionality it is required to configure an SMTP server. This can be done using the following procedure:

![Configuring an SMTP e-mail server](https://3540922554-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHEKskLK6aXinV75Knl%2F-LVwGLttHg6JwapJ93k_%2F-LVwHBVU0ENBie6AE9d4%2Fimage.png?alt=media\&token=fae2b402-22fb-4b71-8a16-44e2d51d8268)

* Navigate to: ***Administration** > **System** > **Environment***
* Ensure to fill in your SMTP server details as shown in above image
* Click the ***Update*** button to save your changes
* If you now logout and try to login again, you will notice a *"Reset Password"* link. This can be used by all of your users, as long as a valid e-mail address has been associated to each user account

{% hint style="warning" %}
Make sure that your SMTP server allows relaying using the provided credentials (user/pass) and from the Exivity host's IP address. Consult your mail server administrator for additional information.
{% endhint %}

## Advanced

### `config.json`

In order to access advanced configuration for all users which can't currently be modified through the interface, edit the file `config.json` in the `web/glass` subdirectory of the [Program directory](https://olddocs.exivity.io/3.4.3/administration/broken-reference).

![The config.json file](https://3540922554-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHEKskLK6aXinV75Knl%2F-LJsRfaGd61Fn6hqDntF%2F-LJsU-8IcZlw_ebJAUlV%2Fimage.png?alt=media\&token=38308440-dd99-4ee3-bacc-9cb3e9bbe918)

The default contents of this file should look like this:

{% code title="config.json" %}

```javascript
{
  "whiteLabel": false,
  "apiHost": null
}
```

{% endcode %}

### Configure a default API domain

When logging in, users have the option to change the API domain by clicking the `Change domain` link:

![Change domain when logging in](https://3540922554-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHEKskLK6aXinV75Knl%2F-LJs_P1ON1LvAW-42yyb%2F-LJs_dKnK-KKIGWc5KoJ%2Fimage.png?alt=media\&token=da551803-d1ba-4cee-8ccb-eecafc3b7c08)

In order to specify a default for all users, edit the `config.json` file and add your default domain as the `apiHost` option:

{% code title="config.json" %}

```diff
{
  "whiteLabel": false,
-  "apiHost": null
+  "apiHost": "https://example.com"
}
```

{% endcode %}

### Full white-label

To never show any Exivity related branding in the interface, set the `whiteLabel` option to `true`:

{% code title="config.json" %}

```diff
{
-  "whiteLabel": false,
+  "whiteLabel": true,
  "apiHost": null
}
```

{% endcode %}

When the `whiteLabel` option is enabled, certain functionality will be disabled in the GUI:

* Manual clearing of caches on the About page.
* Documentation links in the header will be turned off.

Some other elements in the interface have Exivity branding by default. These defaults can be modified to match your brand:

* The title and logo of the application (displayed in browser tabs, sidebar, and so on) can be changed on the [Configuration](https://olddocs.exivity.io/3.4.3/administration/settings) page.
* The sender e-mail address and name for system and notification e-mails on the System page.