---
name: "fusesmb.conf"
section: "5"
platform: "linux"
package: "fusesmb"
version: "0.8.7-1.4"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/fusesmb.conf"
---

# fusesmb.conf(5)

the configuration file for fusesmb

## NAME

fusesmb.conf - the configuration file for **fusesmb**

## FILE FORMAT

The file consists of sections and parameters. A section begins with the name of the section in square brackets and continues until the next section begins. Sections contain parameters of the form: *name* = *value*.

The file is line-based - that is, each newline-terminated line represents either a comment, a section name or a parameter.

Section and parameter names are not case sensitive.

Only the first equals sign in a parameter is significant. Whitespace before or after the first equals sign is discarded. Leading, trailing and internal whitespace in section and parameter names is irrelevant. Leading and  trailing  whitespace in a parameter value is discarded. Internal whitespace within a parameter value is retained verbatim.

Any  line beginning with a semicolon (\`\`**;**'') or a hash (\`\`**#**'') character is ignored, as are lines containing only whitespace.

## SPECIAL SECTIONS

**fusesmb.conf** can contain the following sections:

- The **\[global\]** section

  Section for global parameters.

- The **\[ignore\]** section

  Section for specifying servers and/or workgroups that should not be listed.

- The **\[/***SERVER***\]** section

  Section for server-specific settings. The section name should start with a slash \`\`**/**'' and not end with a slash.

- The **\[/***SERVER***/***SHARE***\]**

  Section for share-specific settings. The section name should start with a slash followed by the server name followed by a slash ending on the share name. It should not end with a slash.

## EXPLANATION OF EACH PARAMETER

This chapter explains each possible option. The section names - specified between parentheses after each option - shows the applicable sections for this option. For example: ( \[global\] ) specifies that this option is only possible for the section \[global\].

- **ignore** ( \[/SERVER\] )

  Ignore this server. Possible values are: true, false, 1 and 0.

  Example: *ignore* = *true*

- **interval** ( \[global\] )

  Interval for scanning the network for shares. Value is a number that specifies the network scanning interval in minutes. If the value is smaller or equal to zero the network is not scanned.

  Example: *interval* = *20*

- **password** ( \[global\], \[/SERVER\], \[/SERVER/SHARE\] )

  Password. Value is string containing the password.

  Example: *password* = *secret*

- **servers** ( \[ignore\] )

  Servers to ignore. Value is each server to ignore separated by a comma.

  Example: *servers* = *SERVER1, SERVER2, SERVER3*

- **showhiddenshares** ( \[global\], \[/SERVER\] )

  Show hidden shares. Possible values are: true, false, 1 and 0.

  Example: *showhiddenshares* = *false*

- **timeout** ( \[global\] )

  Connection timeout in seconds. A server after this timeout is considered offline. Values smaller than 2 seconds are ignored.

  Example: *timeout* = *10*

- **username** ( \[global\], \[/SERVER\], \[/SERVER/SHARE\] )

  Username. Value is string containing the username.

  Example: *username* = *johndoe*

- **workgroups** ( \[ignore\] )

  Workgroups to ignore. Value is each workgroup to ignore separated by a comma.

  Example: *workgroups* = *WORKGROUP1, WORKGROUP2*

## EXAMPLE

```
; Global settings
[global]
; Default username and password
username=user
password=totallysecret
; List hidden shares
showhiddenshares=true
; Connection timeout in seconds
timeout = 10
;Interval for updating new shares in minutes
interval = 10
; Section for servers and/or workgroups to ignore
[ignore]
servers=SERVER,SERVER2,SERVER3
workgroups=WORKGROUP,WG2
; Share-specific settings
[/SERVER/SHARE]
username=john
password=doe
; Server-specific settings
[/SERVER]
username=jane
password=doe
showhiddenshares=true
ignore=true
```

## SEE ALSO

[**fusesmb**(1)](/fusesmb/1.md)

## AUTHOR

Vincent Wagelaar \<vincent@ricardis.tudelft.nl\>.