VNSTAT.CONF

NAME

vnstat.conf - vnStat configuration file

SYNOPSIS

/etc/vnstat.conf

DESCRIPTION

vnstat(1), vnstati(1) and vnstatd(1) all use the same configuration file for storing configuration data. Some of the settings are common for all three programs. The file contains keyword-argument pairs, one per line. Lines starting with Arguments may optionally be enclosed in double quotes (") in order to represent arguments containing spaces. Arguments can be padded with spaces or tabulator characters. A hardcoded default value will be used if a keyword can't be found from the configuration file.

COMMON KEYWORDS

BootVariation

Time in seconds how much the boot time reported by system kernel can variate between updates.

CheckDiskSpace

Enable or disable the checking of at least some free disk space before a database write. 1 = enabled, 0 = disabled.

DatabaseDir

Specifies the directory where interface databases are to be stored. A full path must be given and a leading '/' isn't required.

DayFormat, MonthFormat, TopFormat

Formatting of date in available outputs. Uses the same format as date(1). (vnstat and vnstati only)

Interface

Default interface used when no other interface is specified on the command line. (vnstat and vnstati only)

Locale

Locale setting to be used for prints. This replaces the LC_ALL environment variable. Set to "-" in order to use the system default value. (vnstat and vnstati only)

MaxBandwidth

Maximum bandwidth for all interfaces. If the counted traffic exceeds the given value then the data is assumed to be invalid and rejected. Set to 0 in order to disable the feature. (vnstat and vnstatd only)

MaxBW

Same as MaxBandwidth but can be used for setting individual limits for selected interfaces. The name of the interface is specified directly after the MaxBW keyword without spaces. For example MaxBWeth0 for eth0 and MaxBWppp0 for ppp0. (vnstat and vnstatd only)

MonthRotate

Day of month that months are expected to change. Usually set to 1 but can be set to alternative values for example for tracking monthly billed traffic where the billing period doesn't start on the first day. (vnstat and vnstatd only)

OutputStyle

Modify the content and style of text outputs. 0 = minimal and narrow output for terminal with limited width, 1 = normal output with bar column visible, 2 = same as 1 except rate is visible in summary and weekly outputs, 3 = rate column is visible in all outputs where it is supported. (vnstat and vnstati only)

QueryMode

Default query mode when no parameters are given. 0 = normal, 1 = days, 2 = months, 3 = top10, 4 = dumpdb, 5 = short, 6 = weeks, 7 = hours and 8 = xml. (vnstat only)

RateUnit

Select which unit is used when traffic rate is visible. 0 = bytes, 1 = bits. (vnstat and vnstati only)

RXCharacter, TXCharacter

Character used for representing the percentual share of received and transmitted traffic in daily output. (vnstat only)

RXHourCharacter, TXHourCharacter

Character used for representing the percentual share of received and transmitted traffic in hourly output. (vnstat only)

Sampletime

Defines how many seconds the -tr option will sample traffic. (vnstat only)

TrafficlessDays

Log days without any traffic to daily list. 1 = enabled, 0 = disabled. (vnstat and vnstatd only)

UnitMode

Select how units are prefixed. 0 = IEC standard prefixes (KiB/MiB/GiB/TiB), 1 = old style binary prefixes (KB/MB/GB/TB). (vnstat and vnstati only)

UseFileLocking

Enable or disable the use of file locking during database access. Disabling file locking may cause database corruption if several processes are trying to write to the file at the same time.

DAEMON RELATED KEYWORDS

LogFile

Specify log file path and name to be used if UseLogging is set to 1.

OfflineSaveInterval

How often in minutes cached interface data is saved to file when all monitored interfaces are offline.

PidFile

Specify pid file path and name to be used.

PollInterval

How often in seconds interfaces are checked for status changes.

SaveInterval

How often in minutes cached interface data is saved to file.

SaveOnStatusChange

Enable or disable the additional saving to file of cached interface data when the availability of an interface changes, i.e., when an interface goes offline or comes online. 1 = enabled, 0 = disabled.

UpdateInterval

How often in seconds the interface data is updated.

UseLogging

Enable or disable logging. 0 = disabled, 1 = logfile and 2 = syslog.

IMAGE OUTPUT RELATED KEYWORDS

CBackground

Background color.

CEdge

Edge color if visible.

CHeader

Header background color.

CHeaderTitle

Header title text color.

CHeaderDate

Header date text color.

CLine

Line color.

CLineL

Lighter version of line color. Set to '-' in order to use a calculated value based on CLine.

CRx

Color for received data.

CRxD

Darker version of received data color. Set to '-' in order to use a calculated value based on CRx.

CText

Common text color.

CTx

Color for transmitted data.

CTxD

Darker version of transmitted data color. Set to '-' in order to use a calculated value based on CTx.

HeaderFormat

Formatting of date in header. Uses the same format as date(1).

HourlyRate

Show hours with rate instead of transfered amount. 1 = enabled, 0 = disabled.

SummaryLayout

Select the used layout of the summary output. 1 = layout introduced in version 1.8 with monthly traffic included, 0 = layout used before version 1.8, doesn't contain monthly traffic and doesn't support average rate.

SummaryRate

Show rate in summary output if available. 1 = enabled, 0 = disabled.

TransparentBg

Set background color as transparent. 1 = enabled, 0 = disabled.

FILES

/etc/vnstat.conf

Config file that will be used unless $HOME/.vnstatrc exists or alternative value is given as command line parameter.

AUTHOR

Teemu Toivola <tst at iki dot fi>

SEE ALSO

vnstat(1), vnstati(1), vnstatd(1), units(7)

Index

NAME

SYNOPSIS

DESCRIPTION

COMMON KEYWORDS

DAEMON RELATED KEYWORDS

IMAGE OUTPUT RELATED KEYWORDS

FILES

AUTHOR

SEE ALSO