Notice
This document is for a development version of Ceph.
Installing Ceph on Windows
The Ceph client tools and libraries can be natively used on Windows. This avoidsthe need for additional layers such as iSCSI gateways or SMB shares,drastically improving the performance.
Prerequisites
Supported platforms
Windows Server 2019 and Windows Server 2016 are supported. Previous WindowsServer versions, including Windows client versions such as Windows 10, mightwork but haven’t been tested.
Windows Server 2016 does not provide Unix sockets, in which case some commandsmight be unavailable.
Secure boot
TheWNBD driver hasn’t been signed by Microsoft, which means that Secure Bootmust be disabled.
Dokany
In order to mount Ceph filesystems,ceph-dokan requires Dokany to beinstalled. You may fetch the installer as well as the source code from theDokany GitHub repository:https://github.com/dokan-dev/dokany/releases
Make sure to install Dokany 2.0.5 or later.
UnlikeWNBD, Dokany isn’t included in the Ceph MSI installer.
MSI installer
Using the MSI installer is the recommended way of installing Ceph on Windows.It can be downloaded from here:https://cloudbase.it/ceph-for-windows/
As mentioned earlier, the Ceph installer does not include Dokany, which hasto be installed separately.
A server reboot is required after uninstalling the driver, otherwise subsequentinstall attempts may fail.
The following project allows building the MSI installer:https://github.com/cloudbase/ceph-windows-installer. It can either use prebuiltCeph and WNBD binaries or compile them from scratch.
Manual installation
The following document describes the build process and manual installation:https://github.com/ceph/ceph/blob/master/README.windows.rst
Configuration
Please check theWindows configuration sample to get started.
You’ll also need a keyring file. TheGeneral CephFS Prerequisites page provides asimple example, showing how a new CephX user can be created and how its secretkey can be retrieved.
For more details on CephX user management, see theClient AuthenticationandUser Management.