---
title: login
description: Canonical makes open source secure, reliable and easy to use, providing
  support for Ubuntu and a portfolio of enterprise-grade technologies. Founded in
  2004, Canonical operates globally with team members in over 80 countries.
url: https://canonical-com-2934.demos.haus/maas/docs/login?format=md
---

*Submit*

# login

Log in to a remote API, and remember its description and credentials.

```
maas login [-h] [--cacerts CACERTS] [-k] profile-name url [credentials]
```

#### Positional arguments

| Argument | Effect |
| --- | --- |
| profile-name | The name with which you will later refer to this remote |
|  | server and credentials within this tool |
| url | The URL of the remote API, e.g. <http://example.com/MAAS/> |
|  | or <http://example.com/MAAS/api/2.0/> if you wish to |
|  | specify the API version |
| credentials | The credentials, also known as the API key, for the |
|  | remote MAAS server. These can be found in the user |
|  | preferences page in the web UI; they take the form of a |
|  | long random-looking string composed of three parts, |
|  | separated by colons |

#### Command-line options

| Option | Effect |
| --- | --- |
| -h, --help | show this help message and exit |
| –cacerts CACERTS | Certificate CA file in PEM format |
| -k, --insecure | Disable SSL certificate check |
|  |  |

If credentials are not provided on the command-line, they will be prompted for interactively.

---

[Previous

list](https://canonical-com-2934.demos.haus/maas/docs/list)
[Next

logout](https://canonical-com-2934.demos.haus/maas/docs/logout)

Last updated 1 year, 4 months ago. [Help improve this document in the forum](https://discourse.maas.io/t/login/11345).