Welcome | Get started | Dive into Lino | Contribute | Reference | More
The getlino startsite
command¶
This page is about the getlino startsite
command.
- getlino startsite¶
Create a new Lino site on a Lino server that has previously been
configured using getlino configure
. Optionally reinstall an existing site
or finish an interrupted installation.
Usage¶
The script will ask you some questions:
Run-time behaviour options:
- --batch¶
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
- --db-user¶
See Database settings. If this is empty or not specified,
getlino startsite
will use the server-wide default value specified bygetlino configure --db-user
.
- --db-engine¶
See Database settings. If this is empty or not specified,
getlino startsite
will use the server-wide default value specified bygetlino configure --db-engine
.
- --db-port¶
See Database settings. If this is empty or not specified,
getlino startsite
will use the server-wide default value specified bygetlino configure --db-port
.
- --db-password¶
See Database settings. If this is empty or not specified,
getlino startsite
will use the server-wide default value specified bygetlino configure --db-password
.
- --dev-repos¶
A space-separated list of repositories for which this site uses the development version (i.e. not the PyPI release).
Usage example:
$ 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-env
If this is empty, the new site will get its own virgin environment.
Troubleshooting¶
When getlino startsite
was interrupted, then it gets interesting.
Save the console output for further reference.
Keep in mind that you can invoke
getlino startsite
with the name of an existing site in order to re-install that site.If you aren't sure whether the database has been set up correctly, use the MySQL cheat sheet
Use the source code.
The getlino site.ini file¶
If your applications is not listed in the applications known by getlino or if you'd like to install/deploy django application you can define a filename.ini file (use the example template here). Where appname, prjname, git_repo and settings_module are mandatory options in the getlino section. Everything else is optional. If you are deploying a django (non-lino) you must specify use_django_settings as True.
Then run the command:
# getlino startsite --ini-file filename.ini