SSL Support

Warning

If you are a Cloud user, this section is not relevant for you. You can skip this section.

Obscreen Studio supports SSL certificates through a dedicated plugin (Core Web SSL). This is particularly useful for companies with strict security requirements.

How to enable

Standard SSL Configuration

The SSL Certificate Plugin is typically configured through the Studio Server interface after installation at http://<STUDIO_URL>/plugins in the Plugins section.

SSL Configuration for Restricted Environments

In environments with strict firewall rules that block outbound traffic without a verified SSL certificate, you may encounter a problem where:

1. The application cannot start due to blocked license verification requests
2. You cannot configure the SSL plugin because the app hasn't started yet (unmanage-able obscreen-studio-launcher process is started before obscreen-studio manage-able process)

Workaround for Docker Compose

Add these environment variables, entrypoint and volume configuration to your docker-compose.yml:

services:
  obscreen:
    # ... other configuration ...
    environment:
      REQUESTS_CA_BUNDLE: /usr/local/share/ca-certificates/cert.crt  # or .pem
      SSL_CERT_FILE: /usr/local/share/ca-certificates/cert.crt       # or .pem
      http_proxy: "http://<proxy-ip>:80"
      https_proxy: "https://<proxy-ip>:443"
    entrypoint: >
      /bin/sh -c "update-ca-certificates && python /app/obscreen-studio-launcher.py"
    volumes:
      - ./certs/cert.crt:/usr/local/share/ca-certificates/cert.crt  # Mount certificate