Installing Lino Farm

Install using pip

The easiest way to install Lino Farm is via pip:

$ pip install lino_farm

To update your farm tools to the newest version simply run:

$ pip install -U lino_farm`

Install from source code

You can optionally install your own local clone of lino_farm:

$ cd ~/lino/env/repositories
$ git clone git@gitlab.com:synodalsoft/farm.git
$ pip install -e farm

In that last use case don’t forget to manually add farm to your ./atelier/config.py file.

Configure your servers

~/.farmfile.py

Before using the farm command, you need to create a file ~/.farmfile.py, which populates the list of your servers.

Example content:

from lino_farm.utils import server, site

OVH = "OVH"
HTZ = "Hetzner"

server('one', '12.34.45.78', OVH, 'xyz.ovh.net', 20251007, False, "75GB/8GB")
site("foo.example.com", 'foo')
lino_farm.utils.server()

Defines a server to be managed with farm.

lino_farm.utils.site()

Defines a site on the previously defined server.