Home / Docs / Settings & SSL

Settings & SSL

Server configuration, SSL certificates, and account management

Hostname Configuration

Set your server's hostname in the StreamDev settings panel. The hostname is used for generating stream URLs, SSL certificate requests, and API endpoints. You can use a fully qualified domain name (e.g., stream.example.com) or the server's IP address. If you plan to enable SSL, a valid domain name pointing to your server is required.

Port Settings

StreamDev uses two primary ports:

  • Port 3000 (HTTP): The default port for the web dashboard and HLS stream delivery. Access your panel at http://your-server:3000
  • Port 1935 (RTMP): Used for RTMP ingest from encoders like OBS, Wirecast, and vMix

Ensure both ports are open in your server's firewall. When SSL is enabled, HTTPS traffic is also served through the configured HTTP port.

SSL via Let's Encrypt

StreamDev includes built-in Let's Encrypt integration for automated, free SSL certificates. To enable it:

  • Set a valid domain name as your hostname (the domain must point to your server's IP)
  • Enable Let's Encrypt SSL in the Settings panel
  • StreamDev automatically requests, installs, and configures the certificate
  • Certificates are renewed automatically every 60 days with no manual intervention

Requirement: Port 80 must be temporarily accessible for the Let's Encrypt domain validation challenge. If another service is using port 80, stop it briefly during initial certificate issuance.

Custom SSL Certificate

If you prefer to use your own SSL certificate (e.g., from a commercial CA or a wildcard certificate), you can upload it directly through the settings panel. Provide the certificate file (.crt or .pem) and the private key file (.key). StreamDev will configure HTTPS using your custom certificate. Make sure the certificate chain is complete to avoid browser trust warnings.

Debug Mode

Enable debug mode to get verbose logging output that helps diagnose stream issues, transcoding errors, or connectivity problems. Debug logs are accessible from the dashboard and include detailed FFmpeg output, connection attempts, and error traces. Disable debug mode in production to reduce log volume and improve performance.

Auto-Restart Configuration

StreamDev can automatically restart streams that stop unexpectedly. When auto-restart is enabled, the platform monitors each active stream and attempts to reconnect or re-launch it if it goes offline. You can configure the restart behavior per stream, including the number of retry attempts and the delay between retries. This ensures maximum uptime for mission-critical broadcasts.

System Updates

Keep your StreamDev installation up to date with the latest features and security patches. The settings panel shows your current version and notifies you when an update is available. Updates can be applied directly from the dashboard with a single click. It is recommended to back up your configuration before applying major updates.

Account Management

Manage your StreamDev admin account from the settings page:

  • Change email: Update the email address associated with your admin account
  • Change password: Set a new password for dashboard access (use a strong, unique password)

There is one admin account per StreamDev installation. Keep your credentials secure and do not share them with unauthorized users.