lmn-client/doc/install_ontop.md

Installation on existing client

An easy method to test the lmn-client is to run the playbook manual on a fresh installed client.

Direct call via ansible-pull

With two simple commands you can install the lmn-client with default configuration.

Steps:

• Install debian on client (via USB or PXE)
• Install additional packages: ansible sudo apt install ansible
• Run Playbook ansible-pull -i inventory.yml -l localhost, --url=https://codeberg.org/DigitalSouveraeneSchule/lmn-client.git -C main lmn-client.yml

Checkout git and run ansible locally

When checking out the repository you can customize the installation by editing the inventory before run the playbook.
You can repeat the process as often as you like and gradually adapt your inventory settings to your needs.

Steps:

• Install debian on client (via USB or PXE)
• Install additional packages: ansible, git
  sudo apt install ansible git
• Checkout Repository git clone https://codeberg.org/DigitalSouveraeneSchule/lmn-client.git
• Create inventory
  cp inventory.yml inventory-myschool.yml
• Edit inventory-myschool.yml
  e.g.: nano inventory-myschool.yml
• Run Playbook
  ansible-playbook -i inventory-myschool.yml -l localhost lmn-client.yml

Run with other target device

If you want to run the play on an other target pc:

• You have to add the target IP or hostname in the inventory.
• SSH access on target must be configured (deploy ssh public-key on target host)

ansible-playbook -i inventory-myschool.yml -l target lmn-client.yml

Upload changes to your own remote repository

If you are satisfied with your changes, you can upload the changes to your own remote repository.

• Create new git repository on your git service (e.g. https://codeberg.org)
• Add new remote origin
  git remote add myorigin git@codeberg.org:myname/mylmn-client.git
• Push the repository to the new remote
  push -u myorigin main