src/ceph/doc/cephfs/fstab.rst

   1 ==========================================
   2  Mount Ceph FS in your File Systems Table
   3 ==========================================
   4
   5 If you mount Ceph FS in your file systems table, the Ceph file system will mount
   6 automatically on startup.
   7
   8 Kernel Driver
   9 =============
  10
  11 To mount Ceph FS in your file systems table as a kernel driver, add the
  12 following to ``/etc/fstab``::
  13
  14         {ipaddress}:{port}:/ {mount}/{mountpoint} {filesystem-name}     [name=username,secret=secretkey|secretfile=/path/to/secretfile],[{mount.options}]
  15
  16 For example::
  17
  18         10.10.10.10:6789:/     /mnt/ceph    ceph    name=admin,secretfile=/etc/ceph/secret.key,noatime,_netdev    0       2
  19
  20 .. important:: The ``name`` and ``secret`` or ``secretfile`` options are
  21    mandatory when you have Ceph authentication running.
  22
  23 See `User Management`_ for details.
  24
  25
  26 FUSE
  27 ====
  28
  29 To mount Ceph FS in your file systems table as a filesystem in user space, add the
  30 following to ``/etc/fstab``::
  31
  32        #DEVICE PATH       TYPE      OPTIONS
  33        none    /mnt/ceph  fuse.ceph ceph.id={user-ID}[,ceph.conf={path/to/conf.conf}],_netdev,defaults  0 0
  34
  35 For example::
  36
  37        none    /mnt/ceph  fuse.ceph ceph.id=myuser,_netdev,defaults  0 0
  38        none    /mnt/ceph  fuse.ceph ceph.id=myuser,ceph.conf=/etc/ceph/foo.conf,_netdev,defaults  0 0
  39
  40 Ensure you use the ID (e.g., ``admin``, not ``client.admin``). You can pass any valid
  41 ``ceph-fuse`` option to the command line this way.
  42
  43 See `User Management`_ for details.
  44
  45
  46 .. _User Management: ../../rados/operations/user-management/