# Uncloud Tips


[Uncloud's docs](https://uncloud.run/docs) are great, but a few things are burried a bit. Hence a simple list
of things that can improve your interactions with Uncloud.

# SSH ProxyJump

Sometimes you can not directly connect to a cluster, you first have to SSH into a host that _is_ directly
connected to a cluster. If this is the case use a SSH _proxy jump_ (see ssh(1)). This allows you to, e.g. use a
local docker to build images that can then be pushed to the cluster.

When connecting to a cluster it make sense to use a proxy jump host. In your ~/.ssh/config add:

```
Host uncloud*
    ProxyJump xxxxx.science.ru.nl
```

Where all my uncloud hosts are named, `uncloudXXX`, the above says use xxxxx.science.ru.nl as the proxy jump host.

If ssh-ing into the proxy jump host is difficult as well, due to a 2nd factor use an _ControlMaster_ (see ssh(1)):

```
Host xxxxx.science.ru.nl
ControlMaster auto
    ControlPath ~/.ssh/%r@%h-%p.sock
    ControlPersist 10m
```

# Docker Login

Sometimes you need to reference an image that is hosted inside a registry that requires authentication. In
that case use the _local_ `docker login` to login. Those credentials are automatically pushed to the cluster
and there it will be able to pull the image!