Enable SSL (HTTPS)

Bitstreams supports HTTPS with either self-signed certificates or custom certificates.

Enable HTTPs

HTTPs support needs to be enabled during the installation process, if this has not already be completed follow the instructions below.

1. Navigate to the Bitstreams directory

   cd  ~/Bitstreams_Edge_vX.X.X_*

2. Re-run the install script but specify https

   ./edge_quick_installer.py <server_ip_address> https

3. Wait for the installation to be completed. The installation script will automatically create self-signed certificates.

Add Custom Certificates

Bitstreams requires two (2) files, one is the certificate file (.crt) and the key file (.key).

1. Save both these files on the server

2. Copy the certificate file to the ~/Bitstreams_Edge_vX.Y.Z_*/release/configs/cert with the filename gateway_bundle.crt

3. Copy the key file to the ~/Bitstreams_Edge_vX.Y.Z_*/release/configs/cert with the filename gateway.key

   note

   The filename of the custom certificate files must match the filenames mention the steps. If not then the certificates will be not accepted.

4. Restart the gateway Docker container

   cd ~/Bitstreams_Edge_vX.Y.Z_*/release/configs
   docker compose restart gateway

5. Verify that docker container has been restarted with docker ps. The gateway container's status should be health and less than one minute. See example below.

   CONTAINER ID   IMAGE                                                                                  COMMAND                  CREATED        STATUS                            PORTS     NAMES
   5a1edd24077f   yyz1harbor01.netint.ca/bitstreams/nvs:release_v2.1.1_RC6                               "./nvs --config conf…"   2 days ago     Up 2 days (healthy)                         configs-nvs-1
   2b5d6b867d67   yyz1harbor01.netint.ca/bitstreams/lms:release_v2.1.2_RC2-bqe                           "./lms --config conf…"   2 days ago     Up 2 days (healthy)                         configs-lms-1
   53e212395114   yyz1harbor01.netint.ca/bitstreams/stream-trans:release_v2.1.2_RC2-release_v2.1.2_RC2   "./stream-trans --co…"   2 days ago     Up 2 days (healthy)                         configs-stream-trans-1
   58c3c4de2204   yyz1harbor01.netint.ca/bitstreams/gateway:release_v2.1.2_RC2-release_v2.1.2_RC2-bqe    "/bin/sh -c 'crond &…"   2 days ago     Up 7 seconds (health: starting)             configs-gateway-1
   0c581d73fb63   yyz1harbor01.netint.ca/bitstreams/stream-live:release_v2.1.1_RC1                       "./objs/srs -c conf/…"   2 days ago     Up 2 days (healthy)                         configs-stream-live-1
   b139a583b985   yyz1harbor01.netint.ca/bitstreams/nginx:v1.0.0                                         "/docker-entrypoint.…"   2 days ago     Up 2 days (healthy)                         configs-nginx-1
   e8a0f7e8ce06   yyz1harbor01.netint.ca/bitstreams/redis:7.0                                            "/opt/bitnami/script…"   2 days ago     Up 2 days (healthy)                         configs-redis-endpoint-1
   7bdfd8e4922b   yyz1harbor01.netint.ca/bitstreams/minio:2024.7.15                                      "/opt/bitnami/script…"   2 days ago     Up 2 days (healthy)                         configs-minio-1
   9c58f4f4fd96   yyz1harbor01.netint.ca/bitstreams/mysql:5.7                                            "/opt/bitnami/script…"   2 days ago     Up 2 days (healthy)                         configs-mysql-1
   e81a4d9bf9ac   yyz1harbor01.netint.ca/bitstreams/etcd:3.5.7                                           "/opt/bitnami/script…"   2 days ago     Up 2 days (healthy)                         configs-etcd-1
   ac9f52714ee2   yyz1harbor01.netint.ca/bitstreams/etcdkeeper:v1.0.0                                    "/bin/sh -c './etcdk…"   2 days ago     Up 2 days (healthy)                         configs-etcdkeeper-1
   cfe0a862fdbd   yyz1harbor01.netint.ca/bitstreams/notification:release_v2.1.1_RC1                      "./notification --co…"   3 weeks ago    Up 5 days (healthy)                         configs-notification-1