# Rancher CLI: What does the up command do?

**URL:** <https://forums.suse.com/t/rancher-cli-what-does-the-up-command-do/13604>\
**Category:** SUSE Rancher Prime\
**Created:** [March 12, 2019, 2:42pm UTC](https://forums.suse.com/t/rancher-cli-what-does-the-up-command-do/13604 "2019-03-12T14:42:17Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![Oliver\_Isaac](https://sea2.discourse-cdn.com/flex022/user_avatar/forums.suse.com/oliver_isaac/32/4918_2.png) [@Oliver\_Isaac](https://forums.suse.com/u/Oliver_Isaac)\
**Post date:** [March 12, 2019, 2:42pm UTC](https://forums.suse.com/t/rancher-cli-what-does-the-up-command-do/13604/1 "2019-03-12T14:42:17Z")

</div>

I can’t find documentation on what the rancher v2 CLI `up` command is used for. I’ve seen references to using Kubernetes yaml files but that doesn’t seem to do anything:

```auto
$ cat secret.yaml
apiVersion: v1
kind: Secret
metadata:
  name: mysecret
type: Opaque
stringData:
  username: oliver
  password: P@ssw0rd

$ rancher up -f secret.yaml
$ rancher inspect --type secret mysecret
FATA[0002] Not found: mysecret

```

The `--help` command doesn’t help much as it just tells me to pass in “a compose file” but it seems like docker-compose files aren’t supported:

```auto
$ rancher up --help
apply compose config

Usage:
  rancher up [OPTIONS] [arg...]

Options:
   --file value, -f value The location of compose config file

```

- What type of file should I be using?
- Can someone provide an example file?
- Are there args expected for up? What would an arg be used for?
- More generally, how can we improve the command line documentation so it’s clear what sort of file is expected?

---

<div class="post-metadata">

**Author:** ![Austin-Earl](https://sea2.discourse-cdn.com/flex022/user_avatar/forums.suse.com/austin-earl/32/4916_2.png) [@Austin-Earl](https://forums.suse.com/u/Austin-Earl)\
**Post date:** [March 12, 2019, 2:46pm UTC](https://forums.suse.com/t/rancher-cli-what-does-the-up-command-do/13604/2 "2019-03-12T14:46:22Z")

</div>

I don’t know too much about it, but yes I have had the same question for quite some time.  
The only thing I have found was in the 1.6 documentation for rancher up. Maybe that might help you have a better idea… though the command might be deprecated in 2.0. Hope that helps!

---

<div class="post-metadata">

**Author:** ![Oliver\_Isaac](https://sea2.discourse-cdn.com/flex022/user_avatar/forums.suse.com/oliver_isaac/32/4918_2.png) [@Oliver\_Isaac](https://forums.suse.com/u/Oliver_Isaac)\
**Post date:** [March 12, 2019, 3:11pm UTC](https://forums.suse.com/t/rancher-cli-what-does-the-up-command-do/13604/3 "2019-03-12T15:11:29Z")

</div>

[This previous comment](http://forums.suse.com/t/rancher-cli-not-working-as-expected/11123/5) is where I got the idea to use kubernetes manifests:

> The 2.x and 1.x are basically entirely unrelated, including the CLI. 2.x supports kubernetes manifests, not docker-compose files.