manpages

tape.cfg(5)

TAPE.CFG(5) Proxmox Backup TAPE.CFG(5)

NAME

tape.cfg - Tape Drive and Changer Configuration

DESCRIPTION

The file /etc/proxmox-backup/tape.cfg is a configuration file for Proxmox Backup Server. It contains the tape drive and changer configuration.

FILE FORMAT

Each LTO drive configuration section starts with the header lto: <name>, followed by the drive configuration options.

Tape changer configurations start with the header changer: <name>, followed by the changer configuration options.

lto: hh8


      changer sl3


      path /dev/tape/by-id/scsi-10WT065325-nst
changer: sl3


      export-slots 14,15,16


      path /dev/tape/by-id/scsi-CJ0JBE0059


You can use the proxmox-tape drive and proxmox-tape changer commands to manipulate this file.

NOTE:

The virtual: drive type is experimental and should only be used for debugging.


OPTIONS

Section type 'changer': SCSI tape changer

Required properties:

path
<string> Path to Linux generic SCSI device (e.g. '/dev/sg4')

Optional properties:

eject-before-unload
<boolean> (default=false) if set to true, tapes are ejected manually before unloading
export-slots
[<integer>, ...] A list of slot numbers, comma separated. Those slots are reserved for Import/ Export, i.e. any media in those slots are considered to be 'offline'.

Section type 'lto': Lto SCSI tape driver

Required properties:

path
<string> The path to a LTO SCSI-generic tape device (i.e. '/dev/sg0')

Optional properties:

changer
<string> Tape Changer Identifier.
changer-drivenum
<integer> (0 - 255) (default=0) Associated changer drive number (requires option changer)

Section type 'virtual': Simulate tape drives (only for test and debug)

Required properties:

path
<string> Path to directory

Optional properties:

max-size
<integer> (0 - N) Virtual tape size

COPYRIGHT AND DISCLAIMER

Copyright (C) 2019-2023, Proxmox Server Solutions GmbH

This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/

AUTHOR

Proxmox Support Team

COPYRIGHT

2019-2025, Proxmox Server Solutions GmbH

Wednesday, 24 December 2025 <devbuild>