Generation 1 has been deprecated and is not recommended for new applications.

Generation 1

You can easily secure traffic to your application using TLS (SSL).

Add a Secure Port to Your Manifest

Edit your app’s docker-compose.yml file to create a port mapping for your secure traffic. For most web applications this will be port 443, the standard for HTTPS.

You’ll also need to set the protocol for the port using the convox.port.<port>.protocol label. Use https as the value if you want to get HTTP headers and don’t need to support websockets. Otherwise use tls. For example:

    - convox.port.443.protocol=https
    - 80:3000
    - 443:3000

When you’re done editing, redeploy your application.

$ convox deploy

Your app is now configured to serve encrypted traffic with a self-signed certificate on port 443. To use a real certificate, you will need to acquire an SSL Certificate and apply it to your SSL endpoint. See the following sections for more information.

Acquire an SSL Certificate

Generate a Certificate

You can request an SSL certificate for any domain you control using convox certs generate:

$ convox certs generate
Requesting certificate... OK, acm-01234567890

A confirmation email will be sent to addresses associated with the domain’s WHOIS record. Click the link in the confirmation email to activate your certificate. These certificates, generated by Amazon Certificate Manager, are free and auto-renewing.

Certificate generation is currently only available in certain regions.

Wildcard certificates

You can generate a wildcard certificate with *, e.g. convox certs generate * However, note that the wildcard only covers that level of the domain and not the bare domain. For instance, * will cover, and so on, but not itself.

Purchase a Certificate

You can also purchase an SSL certificate from most registrars and DNS providers. Convox is a fan of Gandi.

Upload your certificate and private key using convox certs create:

$ convox certs create
Uploading certificate... OK, cert-1234567890

Apply the Certificate

You can then apply a certificate to your load balancer with convox ssl update:

$ convox ssl update web:443 cert-1234567890
Updating certificate... OK

Inspect SSL Configuration

You can use the Convox CLI to view SSL configuration for an app.

$ convox ssl
web:443  cert-1234567890  2 months from now

Managing Certificates

The Convox CLI includes commands that let you list, update, and remove SSL certificates.

Listing Certificates

You can see the certificates associated with your account with convox certs:

$ convox certs
ID                DOMAIN        EXPIRES
cert-1234567890   2 months ago
cert-0987654321   2 months from now
acm-d1cf956c7dba  *  10 months from now

User-uploaded certificates will have the name format cert-*. Certificates generated with convox certs generate will have an id like acm-*:

Updating Your SSL Certificate

When it’s time to update your SSL certificate, upload your new certificate and use convox ssl update again:

$ convox certs create
Uploading certificate... OK, cert-0987654321

$ convox ssl update web:443 certs-0987654321
Updating certificate... OK

Removing Old Certificates

You can remove old certificates that you are no longer using.

$ convox certs delete cert-1234567890
Removing certificate... OK