# \[Self-hosted Mender with Kubernetes\] Documentation is missing some steps?

**URL:** https://hub.mender.io/t/self-hosted-mender-with-kubernetes-documentation-is-missing-some-steps/193
**Category:** General Discussions
**Created:** [February 1, 2019, 8:56pm UTC](https://hub.mender.io/t/self-hosted-mender-with-kubernetes-documentation-is-missing-some-steps/193 "2019-02-01T20:56:24Z")
**Posts on this page:** 8
**Page:** 1

<div class="post-metadata">

### Author: ![sabjorn](https://avatars.discourse-cdn.com/v4/letter/s/91b2a8/32.png) [@sabjorn](https://hub.mender.io/u/sabjorn)
#### Post date: [February 1, 2019, 8:56pm UTC](https://hub.mender.io/t/self-hosted-mender-with-kubernetes-documentation-is-missing-some-steps/193/1 "2019-02-01T20:56:24Z")

</div>

Hi!

Hope this post isn’t a pain but i’m having some trouble getting Mender to run in my Kubernetes environment (specifically OpenShift).

In the [integration](https://github.com/mendersoftware/integration) git repo, there is a (minimal) diagram of all of the services which make up the Mender application.

However, when going through the `cluster-setup.md`, I can’t seem to find how the `storage-proxy` fits in to a deployment (it’s conspicuously missing from the Kubernetes section of the doc).

My assumption is that the `storage-proxy` will need a Kubernetes service to allow a connection from the `mender-deployments` component. But, in the doc, it seems to just want to setup direct connection between `mender-deployments` and `minio`. Is the doc out of date?

---

<div class="post-metadata">

### Author: ![mirzak](https://yyz2.discourse-cdn.com/flex036/user_avatar/hub.mender.io/mirzak/32/2056_2.png) [@mirzak](https://hub.mender.io/u/mirzak)
#### Post date: [February 4, 2019, 9:53am UTC](https://hub.mender.io/t/self-hosted-mender-with-kubernetes-documentation-is-missing-some-steps/193/2 "2019-02-04T09:53:52Z")

</div>

Hi @sabjorn , unfortunately this document is definitely out of date and not something that we officially maintain.

I was not even aware it existed and will probably remove it to avoid future confusion or make it more explicit that it is not a maintained/official document.

My suggestion would be to look at the docker-compose files to figure out how it is all connected in that particular setup and try to mimic that.

---

<div class="post-metadata">

### Author: ![0lmi](https://yyz2.discourse-cdn.com/flex036/user_avatar/hub.mender.io/0lmi/32/133_2.png) [@0lmi](https://hub.mender.io/u/0lmi)
#### Post date: [February 4, 2019, 11:47am UTC](https://hub.mender.io/t/self-hosted-mender-with-kubernetes-documentation-is-missing-some-steps/193/3 "2019-02-04T11:47:06Z")

</div>

Hi, @sabjorn

> My assumption is that the `storage-proxy` will need a Kubernetes service to allow a connection from the `mender-deployments` component.

Your assumption is correct, one service is required for internal communication (let’s call it `minio_internal_service` for instance) with deployments service and another one for external (`minio_external_service`). When a deployment is available then deployments service calls S3 API (`minio_internal_service`) to generate unique URI for a device to download an artifact and this URI should contain IP/FQDN of `minio_external_service`.

It’s not necessary to use Minio, any S3 API compatible storage can be used, so, you can also try to use Ceph. We didn’t test it but I believe it should work.

P.S.: It would be really great contribution if you share your configuration with the community.

---

<div class="post-metadata">

### Author: ![sabjorn](https://avatars.discourse-cdn.com/v4/letter/s/91b2a8/32.png) [@sabjorn](https://hub.mender.io/u/sabjorn)
#### Post date: [February 4, 2019, 10:16pm UTC](https://hub.mender.io/t/self-hosted-mender-with-kubernetes-documentation-is-missing-some-steps/193/4 "2019-02-04T22:16:40Z")

</div>

All my work will be on a public git. However, I don’t know how digestible it will be since it is all for an OpenShift template.

Another question:  
What is `mender-etcd` for? It appears in the kubernete files but I can’t find it anywhere else…

---

<div class="post-metadata">

### Author: ![sabjorn](https://avatars.discourse-cdn.com/v4/letter/s/91b2a8/32.png) [@sabjorn](https://hub.mender.io/u/sabjorn)
#### Post date: [February 4, 2019, 10:18pm UTC](https://hub.mender.io/t/self-hosted-mender-with-kubernetes-documentation-is-missing-some-steps/193/5 "2019-02-04T22:18:21Z")

</div>

Operating under the assumption (now confirmed by you), I have indeed been able to get everything up.

Quick question:  
What is `mender-etcd` for? It appears in the kubernetes files but I can’t find any reference to it otherwise…

---

<div class="post-metadata">

### Author: ![0lmi](https://yyz2.discourse-cdn.com/flex036/user_avatar/hub.mender.io/0lmi/32/133_2.png) [@0lmi](https://hub.mender.io/u/0lmi)
#### Post date: [February 5, 2019, 2:55pm UTC](https://hub.mender.io/t/self-hosted-mender-with-kubernetes-documentation-is-missing-some-steps/193/6 "2019-02-05T14:55:47Z")

</div>

> Quick question:  
> What is `mender-etcd` for? It appears in the kubernetes files but I can’t find any reference to it otherwise…

@sabjorn `mender-etcd` is not needed and can be removed.

Also integration/extra/kubernetes contains 4 mender-mongo-\* deployments and related services which is outdated, in some of previous releases this all was merged to use one single DB instance.

---

<div class="post-metadata">

### Author: ![sabjorn](https://avatars.discourse-cdn.com/v4/letter/s/91b2a8/32.png) [@sabjorn](https://hub.mender.io/u/sabjorn)
#### Post date: [February 5, 2019, 7:35pm UTC](https://hub.mender.io/t/self-hosted-mender-with-kubernetes-documentation-is-missing-some-steps/193/7 "2019-02-05T19:35:15Z")

</div>

thanks for getting back to me! This has been a great deal of help!

---

<div class="post-metadata">

### Author: ![mirzak](https://yyz2.discourse-cdn.com/flex036/user_avatar/hub.mender.io/mirzak/32/2056_2.png) [@mirzak](https://hub.mender.io/u/mirzak)
#### Post date: [February 10, 2019, 2:40pm UTC](https://hub.mender.io/t/self-hosted-mender-with-kubernetes-documentation-is-missing-some-steps/193/8 "2019-02-10T14:40:15Z")

</div>

2 posts were split to a new topic: [Self-hosted Mender with Kubernetes (OpenShift)](https://hub.mender.io/t/self-hosted-mender-with-kubernetes-openshift/208)
