How-to Install CoCoS v5 on Debian 12

This manual describes the installation process of CoCoS on Debian 12. Installation on other Linux distributions is considered custom work and will be supported for CoCoS upgrades and updates exclusively on a time-and-materials basis.

System Requirements

The performance and requirements vary per solution. Real-time industrial solutions require more performance then a simple local smal intercom server. The following system resources are used (or configured for virtual environments) for the most commonly deployed systems.

CPU	42 cores (2,5GHz minimal)
Memory	~~8GB~~4GB minimal
Harddisk	The CoCoS system includes extensive logging, historical data storage, periodic backup services, call recording, and traffic tracing, all of which require a significant amount of disk space. Please use larger disk configurations if a high volume of data is expected. Data retention settings can be adjusted if disk space becomes insufficient.
Supported Linux versions	Debian 12 (preferred) Ubuntu 24.04 LTS (supported) Ubuntu 22.04 LTS (technically supported, but discouraged due to end of support in Q2 2027)
Requirements for installation	Network and internet access.

Installation of Debian 12

Linux Source Image

For installation normaly the Debian NetIso which can be found at https://www.debian.org/CD/netinst/#netinst-stable. Don't use Debian images for any other websites then the origional Deibion website.

The default 64bit ISO image for intel cpu's can be download via the following url:
https://cdimage.debian.org/cdimage/archive/12.12.0/amd64/iso-cd/debian-edu-12.12.0-amd64-netinst.iso

Debian 12 Setup guide

CoCoS requires a minimal setup of Debian without graphical user interface. A detailed guid of how to setup Debian 12 can be found here

Prepare for CoCoS installation

Verify that the Debian 12 installation has been completed according to the above instructions. Installing CoCoS requires, just like installing Linux a working network and internet connection.

Start the Linux Debian 12 system bij turning on the server / virtual machine.

After logging in login as user root by using the following command:

su root

Check if the internetconnection is working by executing the following command on the linux commandline:

ping -c 3 repository.cocos.services

IMPORTANT!

If the installation is performed via an SSH terminal (for example, using PuTTY), it is necessary to configure a static IP address.

During the installation, the network configuration will be modified, and when using DHCP, the IP address may change.

Please open the file /etc/network/interfaces by typing the follwoing command:

nano /etc/network/interfaces

After changing the configuration, restart the network-configuration using the following command:

/etc/init.d/networking restart

For more information on how to setup the network configuration on an empty Debian environment visit wikipedia at:

https://wiki.debian.org/NetworkConfiguration#Configuring_the_interface_manually

Please use the following configuration for inspiration / example. Replace the settings using your own network settings.

auto enp2s0
iface enp2s0 inet static
  address 192.167.32.183
  netmask 255.255.255.0
  gateway 192.167.32.254
  dns-nameserver 1.1.1.1

The CoCoS installation script must be executed as the “root” user. If you are logged in as a different user, use the command below to switch to the root user :

su root

The package “curl” must be installed on the system. You can verify this by using the following command

curl --version

If curl is not installed the command will result in "command not found"

If curl is not installed, use the command below to install it:

apt install -y curl

please check the installation again using curl --version.

CoCoS installation

Make sure you Linux Debian installed, setup a fixed IP addres when using SSH and installed curl (if it wasn't installed yet). After all the preperations, you're ready to install CoCoS.

Run the installation command for CoCoS and relax for a while untill the installation is completed. `curl -sSL https://cocos.software/install \| bash`
Note! When the server is rebooted, the default SSH port is changes by de CoCoS setup from 22 to 2022. To change the port, change the ssh configuration.
When the installation is completed, you will be able to login to CoCoS using the webinterface. https://<your server ip address>/apps/management/ default user credentials: user : admin pwd: admin
After login you can install the required software license for CoCoS. If you don't have a license, please contact your supplier.

Firewall

CoCoS is equipped with a firewall. The firewall rules are configured automatically when services and connectors are activated or deactivated. If CoCoS is installed behind an (external) firewall or router, please ensure that the firewall is configured to allow the server to send and receive traffic in accordance with its configuration.

In the table below you will find examples of firewall configurations used in different setups.

Most commonly used firewall rules when CoCoS is setup as an intercom server.