Installation

There are multiple methods to install LibreSBC, but using Ansible is the best choice for convenient and minimize workload. If Ansible is new for you let spend a bit effort to learn it. If you already used Ansible then go head.

Requirements

• LibreSBC Machine: Debian 10 buster.
• Ansible Machine: MacOS/Linux with Ansible ( Ansible installation guide )

Get starts

1. Download the LibreSBC repository source code.

git clone --depth 1 --branch <tag_name> https://github.com/hnimminh/libresbc.git

2. Move to deployment directory

cd libresbc/build/ansible

3. Update Ansible Config, and fill below line:

vi ansible.cfg

[defaults]
private_key_file    = <ssh-private-key-to-access-libresbc>
remote_port         = <ssh-port-of-libresbc-host-default-is-22>
remote_user         = <ssh-username-to-access-libresbc-host>
vault_password_file = <ansible-vault-secret-file>

4. Declare your LibreSBC into Inventory

vi inventories/production/hosts.yml

sbcs:
  hosts:
    <machine-name>:
      ansible_host: <libresbc-machine-ip>
      nodeid: <unique-nodeid>

• ansible_host: ip address of libresbc that ansible machine can ssh to
• nodeid: must be unique name, best practice is using Greek/Japan/Roma God's name or whatever.. as long as they unique and related. nodeid and machine-name can be same.

5. Deployment

ansible-playbook playbooks/deployment.yml -i inventories/production -l "<machine-name>" -t "platform,libre,nginx,firewall"

..and enjoy 👏

Note

There is other method like bash script, docker are not recommended if you not familiar with LibreSBC.*