Knowledge Base

Use the instructions on this page to use OpenSSL to create your certificate signing request (CSR) and install your SSL certificate on your Ubuntu server with Apache2.

For instructions, see Apache: Create CSR & Install SSL Certificate (OpenSSL). For other OS/platform instructions, see Create a CSR (Certificate Signing Request).

You can use these instructions to create OpenSSL CSRs and install all types of DigiCert SSL certificates on your Ubuntu server with Apache2: Standard SSL, EV SSL, Multi-Domain SSL, EV Multi-Domain SSL, and Wildcard SSL.

• To create your certificate signing request (CSR), see Ubuntu with Apache2: Creating Your CSR with OpenSSL.
• To install your SSL certificate, see Ubuntu with Apache2: Installing & Configuring Your SSL Certificate.

Ubuntu with Apache2: Creating Your CSR with OpenSSL

Use the instructions in this section to create your shell commands to generate your Ubuntu with Apache2 CSR with OpenSSL.

Recommended: Use the DigiCert OpenSSL CSR Wizard to generate an OpenSSL command to create your Ubuntu with Apache2 CSR. Fill out the form, click Generate, and paste your customized OpenSSL command into your terminal.

How to Generate a CSR for Ubuntu with Apache 2 Using OpenSSL

If you prefer to build your own shell commands to generate your Ubuntu with Apache2 CSR, follow the instructions below.

1. Log in to your server via your terminal client (ssh).
2. Run Command
   At the prompt, type the following command:
   
   openssl req -new -newkey rsa:2048 -nodes -keyout server.key -out server.csr
   
   Note: Make sure to replace server with the name of your server.
   
3. Generate Files
   1. You've now started the process for generating the following two files:
      • Private-Key File: Used to generate the CSR and later to secure and verify connections using the certificate.
      • Certificate Signing Request (CSR) file: Used to order your SSL certificate and later to encrypt messages that only its corresponding private key can decrypt.
   2. When prompted for the Common Name (domain name), type the fully qualified domain (FQDN) for the site that you are going to secure.
      Note: If you're generating an Apache CSR for a Wildcard certificate, make sure your common name starts with an asterisk (e.g., *.example.com).
   3. When prompted, type your organizational information, beginning with your geographic information.
      Note: You may have already set up default information.
   4. Now, your OpenSSL .csr file is created.
4. Order Your SSL/TLS Certificate
   1. Open the .csr file you created with a text editor.
   2. Copy the text, including the -----BEGIN NEW CERTIFICATE REQUEST----- and -----END NEW CERTIFICATE REQUEST----- tags, and paste it into the DigiCert order form.
5. Save Private Key
   Save (back up) the generated .key file. You need it later to install your SSL certificate.
6. Install Certificate
   After you've received your SSL certificate from DigiCert, you can install it on your server.

Ubuntu with Apache2: Installing and Configuring Your SSL Certificate

If you still need to create a certificate signing request (CSR) and order your certificate, see Ubuntu with Apache2: How to Use OpenSSL to Create Your CSR.

After we validate and issue your SSL certificate, you can install it on your Ubuntu with the Apache2 server (where the CSR was generated) and configure the server to use it.

How to Install and Configure the SSL Certificate on Your Ubuntu Server with Apache2

1. Copy the certificate files to your server.
   1. Log in to your DigiCert account and download the intermediate (DigiCertCA.crt) and your primary certificate (your_domain_name.crt) files.
   2. Copy these files, along with the .key file you generated when creating the CSR, to the directory on the server where you keep your certificate and key files.
      Note: Make them readable by root only to increase security.
2. Find the Apache configuration file you need to edit.
   The location and name of the configuration file can vary from server to server-especially if you're using a special interface to manage your server configuration.
   • The Ubuntu server with Apache2 main configuration file for your SSL/TLS site is typically found in /etc/apache2/sites-enabled/your_site_name.
   • If it's not found in the 'sites-enabled' directory, run the command below.
   • Open the file with a text editor and find the <VirtualHost> blocks that contain the Apache settings.
3. Identify the SSL <VirtualHost> block you need to configure.
   If your site needs to be accessible through both secure (https) and non-secure (http) connections, you need two separate files in /etc/apache2/sites-enabled/. One file is for port 80 and the other file is for port 443. Configure both files for SSL as described in step 4.
   If your site only needs to be accessed securely, configure the existing virtual host for SSL as described in step 4.
4. Configure the <VirtualHost> block for the SSL-enabled site
   1. Below is a very simple example of a virtual host configured for SSL. The parts listed in blue are the parts you must add to configure the SSL configuration; they may be spread throughout the file.
   2. Make sure to adjust the file names to match your certificate files.
      • SSLCertificateFile is your DigiCert certificate file (e.g., your_domain_name.crt).
      • SSLCertificateKeyFile is the .key file generated when you created the CSR (e.g., your_private.key).
      • SSLCertificateChainFile is the DigiCert intermediate certificate file (e.g., DigiCertCA.crt)
        Note: If the SSLCertificateChainFile directive doesn't work, try using the SSLCACertificateFile directive instead.
5. Test your Apache2 configuration file before restarting.
   As a best practice, check your Apache2 configuration file for any errors before restarting Apache.
   Caution: Apache2 won't start again if your configuration files have syntax errors.
   Run the following command to test your configuration file (on some systems, it's apache2ctl):
6. Restart Apache2.
   You can use apachectl commands to stop and start Apache2 with SSL support.
   
   Restart Note: If Apache2 doesn't restart with SSL support, try using apachectl startssl instead of apachectl start. If SSL support only loads with apachectl startssl, we recommend you adjust the apache startup configuration to include SSL support in the regular apachectl start command. Otherwise, your server may require you to manually restart Apache2 using apachectl startssl in the event of a server reboot. This usually involves removing the <IfDefine SSL> and </IfDefine> tags that enclose your SSL configuration.
7. Congratulations! You've successfully installed your SSL certificate.