# Enabling SSL

## 1. Get a certificate

You can use your existing certificate or create a new one using [mkcert](https://github.com/FiloSottile/mkcert) utility.\
Follow the installation [guide](https://github.com/FiloSottile/mkcert#installation) for your platform. 

After installation install mkcert certificate into your system by running the command below:

```bash
mkcert -install
```

Now we need to create a certificate.\
To create a certificate run command below:

```bash
> mkcert localhost 127.0.0.1

Created a new certificate valid for the following names 📜
 - "localhost"
 - "127.0.0.1"

The certificate is at "./localhost+1.pem" and the key at "./localhost+1-key.pem" ✅

It will expire on 13 May 2023 🗓
```

Now we have all files that we need for CMA config.

## 2. Setup CMA

Add to your `cma.js` file field `ssl` with the following object:

```javascript
module.export = {
    ... other configuration
    ssl: {
        enabled: true,
        ssl_certificate: './localhost+1.pem',
        ssl_certificate_key: './localhost+1-key.pem'
    }
}
```

That is it! Just now we have enabled SSL in our application!\
Now to apply changes we need to run [start](https://docs.create-magento-app.com/v1/getting-started/available-commands/start) command **without** [**-s option**](https://docs.create-magento-app.com/v1/getting-started/available-commands/start#s-skip-setup).

{% hint style="warning" %}
You can run **only one** application with SSL enabled at the time because it will use port 443 which is the default port for SSL.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.create-magento-app.com/v1/usage-guide/enabling-ssl.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.