---
name: "plowshare.conf"
section: "5"
platform: "linux"
package: "plowshare"
version: "2.1.7-4"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/plowshare.conf"
---

# plowshare.conf(5)

Configuration file for Plowshare

## NAME

plowshare.conf - Configuration file for Plowshare

## DESCRIPTION

**Plowshare** (plowdown, plowup, plowdel, plowlist or plowprobe) uses a configuration file called *plowshare.conf* for its initial setup. This configuration file is searched for in the following places when plowshare is started:

```
~/.config/plowshare/plowshare.conf
/etc/plowshare.conf
```

Instead of specifying long command lines with user's preferences (credentials, network settings or download retry number, ...), it is convenient to make them default.

Note: Usage of configuration file can be disabled using **--no-plowsharerc** command-line option. There is also **--plowsharerc=***FILE* option to specify an alternate configuration file.

## FILE FORMAT

*plowshare.conf* file uses an INI-style format. It is composed of six sections which may be present in any order. Each section may contain lines of the form:

```
[General]
    token = value
    ...
[Plowdown]
    token = value
    ...
[Plowup]
    token = value
    ...
[Plowdel]
    token = value
    ...
[Plowlist]
    token = value
    ...
[Plowprobe]
    token = value
    ...
# this is a comment
```

Notes:

- •

  Sections are unordered.

- •

  Blank lines or lines beginning with a hash character ('#') are treated as comments and ignored.

- •

  Whitespace before and after a *token* or *value* is ignored (although a *value* can contain whitespace within).

- •

  Double quoting *value* is optional. Use them to preserve leading and trailing whitespace.

Valid tokens are always lowercase. Names are long-option command-line arguments of plowshare. For example: *temp-directory* for plowdown. For modules options, tokens are prepended by module name and a slash character. For example: *rapidgator/auth* (short-option are also possible here).

For values, no backslash interpretation is made. "\\t" is a regular string with two characters, it is not a tab character.

Options in general section prevail over Plow\* section. Options given on the command line prevail over configuration file options.

## EXAMPLE

```
###
### Plowshare configuration file
###
[General]
interface = eth1
rapidshare/a = matt:4deadbeef
rapidgator/a = "matt:4 dead beef "
antigate=bc427381269d702eccc509b8849e5b0d
[Plowdown]
timeout=3600
no-overwrite=1
[Plowup]
max-retries=2
printf=Download URL: %u%nDelete   URL: %d%n
uploadmemodule/auth-free = foo@bar.com:kjguiy1581!
uploadmemodule/folder = incoming
[Plowlist]
verbose = 3
```

## AUTHORS

Plowshare was initially written by Arnau Sanchez. See the AUTHORS file for a list of some of the many other contributors.

Plowshare is (C) 2010-2016 The Plowshare Team

## SEE ALSO

[**plowdown**(1)](/plowdown/1.md), [**plowup**(1)](/plowup/1.md), [**plowdel**(1)](/plowdel/1.md), [**plowlist**(1)](/plowlist/1.md), [**plowprobe**(1)](/plowprobe/1.md), [**plowmod**(1)](/plowmod/1.md).