# Requirements

1.  Ansible 2.8+, available in Debian buster-backports or newer.
2.  Ubuntu 18.04 64-bit server

# Setup

1.  Fill in `bbb_letsencrypt_email` in `bigbluebutton.yml`
2.  On the machine with Ansible, run
    `ansible-galaxy install -r requirements.yml`
3.  If you want phone dial-in to work, modify `bbb_dialin_*` in
    bigbluebutton.yml accordingly.
    -   If you have a public IP and FQDN pointing to the Ubuntu 18.04 box
        1.  Change the `bbb_hostname:` value in bigbluebutton.yml to be
            the FQDN of the Ubuntu box.
        2.  On the machine with Ansible, run
        `ansible-playbook -u [ubuntu_box_username] -i [ubuntu_box_fqdn], bigbluebutton.yml`
    -   If you don't have a public IP for the Ubuntu 18.04 box
        1.  Replace the `bbb_letsencrypt_email:` line in
            bigbluebutton.yml with `bbb_letsencrypt_enable: false`
        2.  Change the `bbb_hostname:` value in bigbluebutton.yml to be
            `ubuntu1804bbb.vm`
        3.  Add a new line in both machines' `/etc/hosts`:
            `[ubuntu_18.04_IP]  ubuntu1804bbb.vm`
        4.  On the machine with Ansible, run
            `ansible-playbook -u [ubuntu_box_username] -i ubuntu1804bbb.vm, bigbluebutton.yml`
4.  If you make any modifications, update the corresponding source code URL in
    `bigbluebutton.yml` to one for a repository containing your modifications.
5.  
    -   If you have a public IP and FQDN pointing to the Ubuntu 18.04 box
        visit https://[ubuntu_box_fqdn]/ in your browser, create an account,
	     click Home, then Start to begin
    -   If you don't have a public IP for the Ubuntu 18.04 box
        1.  Run the following commands on the Ubuntu 18.04 box

                openssl genrsa -des3 -out rootCA.key 4096
                openssl req -x509 -new -nodes -key rootCA.key -sha256 -days 1024 -out rootCA.crt
                cat <<-EOF > fullchain.ext
                authorityKeyIdentifier=keyid,issuer
                basicConstraints=CA:FALSE
                keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment
                subjectAltName = @alt_names

                [alt_names]
                DNS.1 = ubuntu1804bbb.vm
                EOF
                openssl x509 -req -in /etc/letsencrypt/live/ubuntu1804bbb.vm/fullchain.pem.csr -CA rootCA.crt -CAkey rootCA.key -CAcreateserial -out fullchain.crt -days 300 -sha256 -extfile fullchain.ext
                sudo chown root:root fullchain.crt rootCA.crt
                sudo mv fullchain.crt /etc/letsencrypt/live/ubuntu1804bbb.vm/fullchain.pem
                sudo mv rootCA.crt /usr/local/share/ca-certificates
                sudo update-ca-certificates
                sudo docker cp /usr/local/share/ca-certificates/rootCA.crt greenlight-v2:/usr/local/share/ca-certificates
                sudo docker exec greenlight-v2 update-ca-certificates

         2.  Visit https://ubuntu1804bbb.vm/ in your browser, create an account, click Home, then Start to begin

6.  Until https://github.com/ebbba-org/ansible-role-bigbluebutton/issues/328 is resolved you can ssh into the box and do this to use an AGPL MongoDB:

        sudo apt remove mongodb-org mongodb-org-server mongodb-org-tools mongodb-org-mongos mongodb-org-shell
        sudo rm /etc/apt/sources.list.d/*mongo*
        sudo apt update
        sudo apt install mongodb