### Navigation

- next
- previous |
- S3QL v1.10 documentation »

# File System Creation

A S3QL file system is created with the `mkfs.s3ql` command. It has the following syntax:

    mkfs.s3ql [options] <storage url>

This command accepts the following options:

> `--cachedir <path>`
> | Store cached data in this directory (default: `~/.s3ql)`
> `--authfile <path>`
> | Read authentication credentials from this file (default: `~/.s3ql/authinfo2)`
> `--debug <module>`
> | activate debugging output from <module>. Use `all` to get debug messages from all modules. This option can be specified multiple times.
> `--quiet` | be really quiet
> `--ssl` | Always use SSL connections when connecting to remote servers. For backends that allow only encrypted connections, S3QL uses SSL automatically, even if this option is not set.
> `--version` | just print program version and exit
> `-L <name>` | Filesystem label
> `--max-obj-size <size>`
> | Maximum size of storage objects in KB. Files bigger than this will be spread over multiple objects in the storage backend. Default: 10240 KB.
> `--plain` | Create unencrypted file system.
> `--force` | Overwrite any existing data.

Unless you have specified the `--plain` option, `mkfs.s3ql` will ask you to enter an encryption password. This password will not be read from an authentication file specified with the `--authfile` option to prevent accidental creation of an encrypted bucket.

### Navigation

- next
- previous |
- S3QL v1.10 documentation »