Options in Details
Tweaking CrossBox Server to fit your needs is as easy as enabling and disabling features with a simple checkbox click. CrossBox will auto-detect if some kind of a control panel is already installed on the server and will auto-adjust itself. Here we have listed all the options and associated help descriptions.
CrossBox will try to automatically resolve a hostname of the server it's being installed onto.
However, make sure that before installing CrossBox you have a valid PTR (Reverse DNS) record that matches your hostname and that your hostname can be successfully resolved.
Public IP Address
CrossBox will try to automatically resolve an IP address of the server it's being installed onto.
Enter a Port number that CrossBox will bind to and listen on.
If you're installing master server this option is disabled and ports 80/443 are enforced. Otherwise, you can specify a custom port.
Please make sure that App port(s) are not used by some other software running on the server.
If you have a firewall in place, please make sure that binding to these ports is allowed.
App Port cannot be changed after the installation.
We strongly recommend that you enable the SSL feature. Not only it will help protect data being sent over the network from prying eyes, but it is also needed for audio and video calls to work. It is very easy to set up and you have four options to choose from:
- Generate SSL certificates automatically (by using Let's Encrypt Certbot)
- Select from an auto-detected list (will scan the system for existing certificates) - this is visible if the installer detects SSL certificates
- Enter .crt/pem .key paths (lets you enter paths to certificate files)
- Upload .crt/pem and .key files (lets you upload certificate files)
CrossBox uses Coturn as a fast and reliable TURN/STUN server. It is responsible for streaming audio and video data during the CrossBox audio/video conference and for relaying media traffic when persons attending the call can't reach each other directly via the peer-to-peer protocol. This is most often the case when the person is behind a corporate firewall.
Overall, enabling a TURN/STUN server will greatly improve the quality of audio and video calls. The CrossBox Installer will give you the ability to choose if you wish to enable TURN/STUN integration and will also allow you to decide where it should be hosted.
You can choose to install it on the same server as CrossBox or you can enter an external server to offload audio and video streaming to a separate machine in the case you have thousands of concurrent calls being made.
If you plan on having more than 50 people streaming audio and video at the same time, please make sure that you allocate enough CPU/Network resources for your TURN/STUN server. The other approach would be to offload media streaming to a Coturn server hosted on another machine, by choosing "Use external coturn server" and filling in Host and SSL Host fields.
Coturn Non-SSL Port
Enter a non-SSL port that Coturn will use. The default Coturn non-SSL port is 3478.
Coturn UDP Port Range
You may leave the default value. If not, please enter a port range in format 12345:13456. The default value is 49152:65535.
CrossBox has a built-in update system that keeps your installation up to date and automatically updates CrossBox when new updates are available.
At what hour to perform an update
Enter an hour when you wish to check for updates. Uses a 24h format and accepts a number between 0 and 23. 0 means 00:00.
Max Number of Workers
Max number of CPU cores that the application will utilize. Depending on the application traffic/usage you can specify a maximum number of workers based on the number of cores your server has.
Each worker takes about 70-100 MB of RAM.
Max Request Size
In megabytes, enter maximum request body size that the end user can send. For example, users won't be able to upload a file larger than what's defined here. The default value is 1024MB.
Chat Channel Max Participant Count
The maximum number of participants allowed in a chat channel. Increase this if you plan on having more than 50 persons attending. This is a per one channel (room) limitation.
Admin E-mail Address
Admin e-mail address. You may use any email address you want.
This password should be very complex.
Choose the default language for the App. If you want to add your own language, you can do so by translating a language file and sending it back to us. We will then ship it with the next update.
In case of an error, the server will securely send us the traceback and the message - so our team can detect and fix the issue ASAP, with an aim of minimizing the bug's impact on larger audiences.
Use CrossBox MySQL database
Enable if you don't have a MySQL server already running on the server.
If you enable this feature, CrossBox will use its own MariaDB (MySQL) server for storing users' data. Otherwise, it will try to connect to a MySQL server already running on the system and use that server for storing database data.
You can also uncheck this option to enter MySQL server details manually. This is useful if you're connecting CrossBox to remote MySQL server or a MySQL Cluster.
Root MySQL user is required. The root privileges are required because CrossBox manages the creation of users' databases.
Enable mail server integration
- Use the mail server already running on the machine (for example when installing on a cPanel/Plesk/Direct Admin server)
- Automatically install and set up a CrossBox mail server (when installing a bare metal/standalone version, or a mail server is not found on the server)
In the first case, the installer will try to find locally available IMAP/SMTP servers and use those for everything related to email.
In the second case, you'll be able to enable or disable following mail server features:
Enable Anti-Virus Service
Enable this if you want an anti-virus to scan emails for malicious content. Currently, only ClamAV is supported. If you have ClamAV already running on the server, CrossBox will use that one automatically.
ClamAV requires 600 MB of RAM.
Enable Anti-Spam Service
Enable this if you want an anti-spam service to check whether the e-mail being sent/received is spam or not. Automatic spam/ham learning is also enabled with this service.
Enabling this service requires an additional 250 MB of RAM.
E-mail Message Max Size
Enter the maximum allowed email message size in megabytes. Generally, it should not exceed 50MB.
Automatically create postmaster@ and admin@
This can save you some time by creating often needed email addresses automatically for you.
To track App usage in real time you need to enter a valid Google Analytics Tracking ID in UA-XXXXX-Y format.
CrossBox Document Converter (CDC)
Service that allows users to view (.docx, .doc, .xls, .ppt + many others) without having to download the files on their device. Users can also download PDF versions of various formats that are supported. This service requires at least 100MB of RAM
Branding is a great way to white label CrossBox as your own product or service. You can give it a custom name, upload your own logo and change the color scheme to best match your brand. Also, branding addon allows you to have a fully branded CrossBox Client Apps (Web, Desktop, Android & iOS).
Branding feature is most useful for service and hosting providers.
Enter a custom name for the application.
Enter a custom Application slogan or a motto. This is usually shown beneath the App Name.
App Product URL
URL of the web page advertising the application. Users are taken to this URL when they want to find out more about the App.
Lets you brand the App with your own color scheme. Apart from that, you can also upload your own App logo. Image for the logo should be in a PNG format with 1024x1024 px dimensions. CrossBox will then use that image to create logo versions of different dimensions used throughout the application.
iOS and Android App Settings
iOS and Android sections let you define App manifests that Apple and Google stores require when publishing the Apps. You will need to fill in a couple of details:
- App Identifier (This is the Application ID. For example, com.example.appname)
- App Author (The name of the Author)
- App Author E-mail (E-mail address of the author)
- App Support URL (URL where you provide customer support)
This enables push notifications for your branded CrossBox Android and iOS Apps. They keep your end users up to date with new emails, chats, calls, files, and reminders.
GCM is not recommended anymore. Please use FCM - Firebase Cloud Messaging. We strongly recommend that you use FCM for both Android and iOS versions.
When using FCM, you need to obtain FCM Sender ID and FCM Key. Please follow this blog post to find out how to obtain these.
We do not recommend using APNs, use FCM instead. If you insist on using APNs, then you'll need to obtain APNs certificate as explained in "Generate an APNs client TLS certificate" and then upload it by using "Upload APNs Certificate" upload box during the installation.