getlino configure command¶
- getlino configure¶
If you run this command as root (using
sudo), it will turn the machine
into a production server or a demo server by also installing
system packages and system-wide configuration files. Otherwise it will install
Lino into a virtual environment. If you want Lino to install into an
existing virtual environment, you should activate it before running
getlino configure in order to use it as the default value for
getlino configure asks a lot of questions, one question for each server
configuration option. Read the docs below for more explanations. You can answer
ENTER to each question if your don’t care.
getlino configure creates or reads and updates a configuration file where
it stores your answers. Depending on whether you are root, the configuration
file will be either
If you specify
--batch, every option gets its default value, which you
may override by specifying command-line arguments. Use this option only when you
know what you want (e.g. in a Dockerfile).
getlino configure as root, you may want to run it once more
without being root, because only then it will also write a
.bash_aliases file in your home directory.
Run-time behaviour options:
Run in batch mode, i.e. without asking any questions. Assume yes to all questions.
Server configuration options
Full path to your default virtualenv.
Default value is taken from
VIRTUAL_ENVenvironment value. If this is empty, every new site will get its own virgin environment.
Base directory for your shared repositories. This is where getlino should clone repositories of packages to be used in editable mode (“development version”) specified by
getlino startsite --dev-repos.
Whether to install development tools (used to build docs and run tests).
The root directory for Lino’s log files on this server. Each new site will get its entry below that directory.
The root directory for backups on this server. Each new site will get its entry below that directory. Used e.g. by
The root directory for sites on this server.
New sites will get created below that directory (with another level named by
Prefix for local server-wide importable packages.
Relative directory or symbolic link to the virtualenv.
Relative directory or symbolic link to repositories.
Fully qualified domain name of this server. Default is ‘localhost’.
Default settings for new sites
Which front end (
default_ui) to use on new sites.
Whether new sites should have a
linod.shscript which runs the
When running as root, this will also add a
supervisorconfiguration file which runs the
Default value is ‘mysql’ when running as root or ‘sqlite3’ otherwise.
A shared database username to use for all sites on this server.
If this is set, you must also set
Used during development and testing when you prefer to have a single database user for all databases. For security reasons these options should not be used on a production server.
The port to use for connecting to the database server when
Whether this server provides LibreOffice service needed by sites that use
Whether new sites should have webdav.
Whether this server provides an LDAP service. Not tested.
Whether this server provides secure http.
This option will cause getlino to install certbot.
When you use this option, you must have your domain name (
--server-domain) registered so that it points to the server. If your server has a dynamic IP address, you may use some dynamic DNS service like FreedomBox or dynu.com.
getlino startsite command¶
- getlino startsite¶
The script will ask you some questions:
Run-time behaviour options:
Whether to run in batch mode, i.e. without asking any questions. Assume yes to all questions. Don’t use this on a machine that is already being used.
Settings for the new site
A space-separated list of repositories for which this site uses the development version (i.e. not the PyPI release).
$ getlino startsite avanti mysite --dev-repos "lino xl"
Not that the sort order is important. The following would not work:
$ getlino startsite avanti mysite --dev-repos "xl lino"
Full path to the shared virtualenv to use for this site. Default value is the value specified during
getlino configure --shared-envIf this is empty, the new site will get its own virgin environment.
Multiple database engines on a same server¶
When you maintain a Lino server, you don’t want to decide for each new site
which database engine to use. You decide this once during
configure. In general, apt-get install is called only during
configure, never during
getlino startsite. If you have a server with
some mysql sites and exceptionally want to install a site with postgres, you
getlino configure before calling
You may use multiple database engines on a same server by running configure between startsite invocations.