# Using Machines

## Create a Machine

{% tabs %}
{% tab title="Web UI" %}
The steps below describe how to Create a new Machine via the UI.

Navigate to the Machines page and click "New Machine +" at the top-right:

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-LjYE8xOwLqOFPvIACk_%2F-LjYCIGNyvsYwfLJ5BFr%2FScreen%20Shot%202019-07-11%20at%206.43.52%20PM.png?alt=media\&token=41dcc5ec-ecd8-481b-a1c8-9b904b0feb09)

This will take you to the Machine Create page.

There, select the Region where you want your Machine to reside:

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-LjYE8xOwLqOFPvIACk_%2F-LjYCx2TuJvggjo8v8Tl%2FScreen%20Shot%202019-07-11%20at%206.40.09%20PM.png?alt=media\&token=cd65facf-ebe0-4285-8c9c-041b64295c0b)

Choose the OS for your Machine:

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-LjYE8xOwLqOFPvIACk_%2F-LjYDMtmoJJxHaVrVXst%2FScreen%20Shot%202019-07-11%20at%206.40.23%20PM.png?alt=media\&token=c6c68700-07a8-441d-ae5d-3261b53114a8)

Toggle whether you want your Machine to bill hourly or monthly, and select your Machine type depending on your desired CPU or GPU:

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-LjYE8xOwLqOFPvIACk_%2F-LjYD_OTO47sK3cqlc1k%2FScreen%20Shot%202019-07-11%20at%206.40.34%20PM.png?alt=media\&token=19c50ddd-51ff-4c01-9424-0ea13269ee8b)

Select the amount of Storage you want:

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-LjYE8xOwLqOFPvIACk_%2F-LjYDgokUBOpzshe4Voo%2FScreen%20Shot%202019-07-11%20at%206.40.42%20PM.png?alt=media\&token=b0385729-81d5-4cb4-a318-05cd709486be)

You can then specify how many of these Machines you want to create, and type in a name for each of them by clicking the input field that says `New Machine 1` below, for example.

Note that you can also click "Assign Machine" to assign that machine to a particular user on your team, if you are on a team:

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-LjYE8xOwLqOFPvIACk_%2F-LjYDrbTjvlJ6eq_eOOw%2FScreen%20Shot%202019-07-11%20at%206.40.52%20PM.png?alt=media\&token=8c7ee423-ceaf-437a-a751-904136e48d70)

Then choose a Network if desired:

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-LjYRhh-VUdYbJ1FQ4pR%2F-LjYPoJSQ50herTlAhYl%2FScreen%20Shot%202019-07-11%20at%206.40.58%20PM.png?alt=media\&token=6bdc94b0-e5fa-405d-bdca-171267c60d99)

Toggle whether you want Auto-Shutdown, Auto Snapshot, and Public IP.

If Auto-Snapshot is enabled, then select the period of time after which auto-shutdown should occur. This is useful, for example, in order to avoid being billed for machine time that you aren't using your Machine but may have forgotten to turn it off.

If Auto Snapshot is enabled, then select the frequency at which you want a snapshot of your Machine to be created and persisted. This is useful in order to ensure that you have a regular backup of your Machine.

If Public IP is enabled, your Machine will be assigned a single static address. This is useful, for example, if you are using your Machine as a persistent server or for a web app.

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-LjYRhh-VUdYbJ1FQ4pR%2F-LjYR2S7cxhe1Xt5-TxG%2FScreen%20Shot%202019-07-11%20at%206.41.04%20PM.png?alt=media\&token=749b2e92-49f8-4abb-bd23-691a58eba5cf)

Finally, click Create Your Paperspace to create your Machine. You will see the amount you'll initially be billed (for Storage) as well as the ongoing hourly or monthly cost for the Machine. You can also apply any Promo Code and verify your credit card information before doing so.

![](https://1320806315-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LHZRFUkajubOAmgu6Rd%2F-LjYRhh-VUdYbJ1FQ4pR%2F-LjYRXnoXA5EvaHZuzK8%2FScreen%20Shot%202019-07-11%20at%206.43.02%20PM.png?alt=media\&token=87b6ac61-fb79-40cb-8358-8665e879c76d)

Et voilà! Your Machine will spin up in the background, and you'll see it appear back on the Machines list page.

Note that there are additional capabilities to those available in the Web UI that are accessible via the CLI/API, such as machine startup scripts, so be sure to check out the CLI toggle for this section for more information.
{% endtab %}

{% tab title="CLI" %}
**Usage:**&#x20;

```bash
gradient machines create [OPTIONS]
```

Create a new Paperspace virtual machine. If you are using an individual account, you will be assigned as the owner of the machine. If you are a team administrator, you must specify the user that should be assigned to the machine, either by specifying a user id, or by providing an email address, password, first name and last name for the creation of a new user on the team.

**Parameters:**

| Name                                                                                                                                       | Description                                                                                                                                                                 |
| ------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `region [CA1\|NY2\|AMS1]`                                                                                                                  | Name of the region (required)                                                                                                                                               |
| <p><code>machineType [Air|Standard|Pro|Advanced|GPU+|P4000|P5000|</code></p><p><code>P6000|V100|C1|C2|C3|C4|C5|C6|C7|C8|C9|C10]</code></p> | Machine type (required), pick one                                                                                                                                           |
| `size (INTEGER)`                                                                                                                           | Storage size for the machine in GB (required)                                                                                                                               |
| `billingType [monthly\|hourly]`                                                                                                            | Either monthly or hourly billing (required)                                                                                                                                 |
| `machineName`                                                                                                                              | A name for this machine (required)                                                                                                                                          |
| `templateId`                                                                                                                               | Template id of the template to use for creating this machine (required)                                                                                                     |
| `assignPublicIp`                                                                                                                           | Assign a new public ip address on machine creation. Cannot be used with `dynamicPublicIp`                                                                                   |
| `dynamicPublicIp`                                                                                                                          | Assigns a new public ip address on machine  start and releases it from the account on machine stop. Cannot be used with `assignPublicIp`                                    |
| `networkId (TEXT)`                                                                                                                         | If creating on a specific network, specify its id                                                                                                                           |
| `teamId (TEXT)`                                                                                                                            | If creating the machine for a team, specify the team id                                                                                                                     |
| `userId (TEXT)`                                                                                                                            | If assigning to an existing user other than yourself, specify the user id (mutually exclusive with email, password, firstName, lastName)                                    |
| `email (TEXT)`                                                                                                                             | If creating a new user for this machine, specify their email address (mutually exclusive with userId)                                                                       |
| `password (TEXT)`                                                                                                                          | If creating a new user, specify their password (mutually exclusive with userId)                                                                                             |
| `firstName (TEXT)`                                                                                                                         | If creating a new user, specify their first name (mutually exclusive with userId)                                                                                           |
| `lastName (TEXT)`                                                                                                                          | If creating a new user, specify their last name (mutually exclusive with userId)                                                                                            |
| `notificationEmail (TEXT)`                                                                                                                 | Send a notification to this email address when complete                                                                                                                     |
| `scriptId (TEXT)`                                                                                                                          | The script id of a script to be run on startup. See [the Script Guide](https://github.com/Paperspace/paperspace-node/blob/master/scripts.md) for more info on using scripts |
{% endtab %}
{% endtabs %}
