==============================
 Install Ceph Storage Cluster
==============================

This guide describes installing Ceph packages manually. This procedure
is only for users who are not installing with a deployment tool such as
``cephadm``, ``chef``, ``juju``, etc. 


Installing with APT
===================

Once you have added either release or development packages to APT, you should
update APT's database and install Ceph:

.. prompt:: bash $

   sudo apt-get update && sudo apt-get install ceph ceph-mds


Installing with RPM
===================

To install Ceph with RPMs, execute the following steps:


#. Install ``yum-plugin-priorities``:

   .. prompt:: bash #

      sudo yum install yum-plugin-priorities

#. Ensure ``/etc/yum/pluginconf.d/priorities.conf`` exists.

#. Ensure ``priorities.conf`` enables the plugin::

     [main]
     enabled = 1

#. Ensure your YUM ``ceph.repo`` entry includes ``priority=2``. See
   :ref:`packages` for details::

     [ceph]
     name=Ceph packages for $basearch
     baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/$basearch
     enabled=1
     priority=2
     gpgcheck=1
     gpgkey=https://download.ceph.com/keys/release.asc
     
     [ceph-noarch]
     name=Ceph noarch packages
     baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/noarch
     enabled=1
     priority=2
     gpgcheck=1
     gpgkey=https://download.ceph.com/keys/release.asc
     
     [ceph-source]
     name=Ceph source packages
     baseurl=https://download.ceph.com/rpm-{ceph-release}/{distro}/SRPMS
     enabled=0
     priority=2
     gpgcheck=1
     gpgkey=https://download.ceph.com/keys/release.asc


#. Install pre-requisite packages:

   .. prompt:: bash $

      sudo yum install snappy gdisk python-argparse gperftools-libs


Once you have added either release or development packages, or added a
``ceph.repo`` file to ``/etc/yum.repos.d``, you can install Ceph packages:

.. prompt:: bash $

   sudo yum install ceph


Installing a Build
==================

If you build Ceph from source code, you may install Ceph in user space by
executing the following:

.. prompt:: bash $

   sudo ninja install

If you install Ceph locally, ``ninja`` will place the executables in
``usr/local/bin``. You may add the :ref:`Ceph configuration file <configuring-ceph>` to the
``usr/local/bin`` directory to run Ceph from a single directory.

