Installing and launching software

Hardware recommendations


  • 64-bit processor with SLAT and Hyper-V support

Whether your processor supports Intel virtualization technology can be found at

https://www.intel.ru/content/www/ru/ru/support/articles/000005486/processors.html

  • If Linux: Kernel is not older than 3.10
  • If Windows: 10 Pro or higher
  • 8 GB RAM
  • 100 GB HDD

General information

Link can be supplied:

  • in multiple Docker containers and deployed with docker-compose
  • in the Virtualbox virtual machine image

The software has 2 versions:

It is recommended to use a Linux system to install the extended version of the software.

Installing Link under Linux using Docker


  1. Install Docker for your distro. The example below uses the installation for Ubuntu.

    # Remove old versions
    
    sudo apt-get remove docker docker-engine docker.io containerd runc
    
    # Configure the repo
    ## Update apt index and install dependencies
    
    sudo apt-get update
    
    sudo apt-get install \
        apt-transport-https \
        ca-certificates \
        curl \
        gnupg \
        lsb-release
    
    ## Add Docker GPG key
    
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
    
    ## Add repo
    
    echo \
      "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
      $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
    
    
    # Install Docker
    
    sudo apt-get update
    
    sudo apt-get install docker-ce docker-ce-cli containerd.io
  2. Install docker-compose for your distro.

    # Download docker-compose
    
    sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
    
    # Grant execute permission for the file
    
    sudo chmod +x /usr/local/bin/docker-compose
    
    # Add symlink
    
    sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
  3. Clone the project from our Github repo.

    git clone https://github.com/basip/link.git


    The project includes:

    1. base docker-compose.yml version
      1. without http proxy
      2. with http proxy
    2. extended docker-compose.yml version
      1. without http proxy
      2. with http proxy
    3. Change settings for parts of the application, if required.
      • For all configurations it is possible to change:
        • external ports
        • application DB password
        • SIP proxy DB password
      • For configurations with http proxies, you need to change:
        • the value of the HTTPS_DOMAIN variable in the .env file to the used domain name
        • the HTTPS_MODE value to "production". The "staging" value can be used for tests for obtaining a LetsEncrypt certificate, see the documentation for details
  4. For the advanced version, create the required docker volumes

    docker volume create --name=app-data
    docker volume create --name=app-storage
    docker volume create --name=system-logs
  5. For the proxy version, create the required docker volume:

    docker volume create --name=app-ssl-certs
  6. Run the project.

    docker-compose up -d

После успешного запуска проекта приложение будет доступно на 80/443 порту IP адреса вашего сервера, в зависимости от выбранной версии проекта. 

Installing via VirtualBox


To run Link via VirtualBox you need:

  1. Download and install the latest version of VirtualBox VM.
  2. Download the latest Link image via link.
  3. Run VirtualBox and click "File" - "Import appliances" and choose downloaded link_latest image.

       4. After clicking "Next" you can choose some import parametres (OS type, RAM capacity, preferable controllers, adapters and directories). You can also click "Import" without any changes.

       5. When import's complete, you can run link_latest virtual machine.  


You should wait a few minutes while virtual machine is getting ready. You'll see Link's IP address from the virtual machine's GUI.

Then you can access Link web interface via your web browser.



To remove Link you need:

  1. docker stop link
  2. docker system prune - removes Link data and all containers