---
title: "Client setup\n    | Ubuntu"
description: Ubuntu is an open source software operating system that runs from the
  desktop, to the cloud, to all your internet connected things.
url: https://ubuntu.com/ceph/docs/client-setup?format=md
keywords: index, follow
---

*Submit*

# Client setup

This appendix shows how to set up a test client host that can be used for deployment verification purposes in the Storage types and [LXD](https://ubuntu.com/ceph/docs/lxd) integration sections.

The client is created within the Juju model used by the given deployment. Begin by deploying the ubuntu application (and giving it an application name of ‘ceph-client’):

```
juju deploy ubuntu ceph-client
```

Generate a minimal ceph.conf file, make a local copy, and transfer it to the client:

```
juju ssh ceph-mon/0 sudo ceph config generate-minimal-conf | tee ceph.conf
juju scp ceph.conf ceph-client/0:
```

Connect to the client:

```
juju ssh ceph-client/0
```

**On the client host,**

Install the required software, put the ceph.conf file in place, and set up the correct permissions:

```
sudo apt install -y ceph-common
sudo mv ~ubuntu/ceph.conf /etc/ceph
sudo chmod 644 /etc/ceph/ceph.conf
sudo chown root: /etc/ceph/ceph.conf
```

---

[Previous

Appendices](https://ubuntu.com/ceph/docs/appendices)
[Next

Charm list](https://ubuntu.com/ceph/docs/charm-list)

This page was last modified 3 years ago. [Help improve this document in the forum](https://discourse.ubuntu.com/t/client-setup/18765).