install

Overview

Use install for deterministic module placement: choose Base or Minimum, pin an exact compatible release, inspect dependencies, select another extension file or repository deliberately, and leave version upgrades to upgrade.

Installation and upgrading are different operations

Use install to add or remove modules and to choose Base, Minimum, an exact release or another repository. Once a module is installed, version replacement and dependency repair belong to upgrade.

Syntax

install [mod ...] [repo] [options]

Reference

Packages

Base is the complete current functionality. Minimum is available only when the module publishes a functional minimum package. The package choice is stored in the installation marker and is preserved by upgrade.

Dependencies

Hard dependencies are read from compatibility metadata and installed recursively before the requested module. Cycles stop installation. A dependency cannot be removed while an installed module declares it. Optional feature links are shown as @module in server help and do not install anything silently.

Compatibility

The repository must publish .version.txt and .compat.json for every release. Both latest and exact -v requests are checked against LIL_CORE_MAJOR. A lil.core.v1 installation cannot load a release published only for a later generation.

Writing and validation

Downloaded files are size-limited. PHP source is normalized, compacted, parsed as a trait snippet, checked for the expected command method and checked for conflicts. The new extension is written through a temporary file and atomic rename. Numbered repository versions are immutable.

Responsibility boundary

install installs or removes. upgrade checks versions, replaces existing module blocks and repairs installed dependencies. install is called by upgrade only when a required dependency is completely absent.

Secondary commands

Documented secondary names resolve to their owning module: download → upload, patch → diff, coo → ses, read → echo and mariadb → mysql. They share the owner module release stream.

Automatic interactive installation

The current Base lil-core can invoke Installer through the @command prefix. This path is intentionally narrower than an explicit install: it resolves the command's canonical owner, uses only the default lil-repository, selects the current public Base release, suppresses the installation report and resumes the original interactive command. It does not select Minimum, development versions or custom repositories. Explicit install remains the interface for those choices.

Bulk module operations

install dns pwd del installs each named Base module in order. Commas and semicolons are accepted as name separators as well. uninstall dns pwd del removes each module independently and reports every result, so one failure does not hide the status of the remaining items. Options that describe a single module, repository or file stay in the ordinary single-module form.

Repository sources

The <repo> argument may point to another HTTPS repository or to a local directory with the same repository layout. Local sources are useful for controlled testing; the lil-repository remains the default.

Dependency reports

When a requested module installs or refreshes a hard dependency first, the dependency report and the requested-module report are separated by a blank line. Bulk install and uninstall likewise keep every module result as its own visual block.

Install and manage

Install the current compatible version. Choose Base for the complete feature set or Minimum for the reduced package; use upgrade to update a module that is already installed.

Base and Minimum are two packages of the same current module release, not separate command versions.

Examples

Examples are copyable command lines, not actions executed by this website. Review paths, permissions and destructive flags before running them on a real project.

Built-in pwd

Installed find, v1.7 (base)
    repo.lil.dog > .lil.php

Installed dns, v1.8 (base)
    repo.lil.dog > .lil.php

\sandbox\logs\errors.log

setup.lil not found

Installed upgrade, v1.12 (base)
    repo.lil.dog > .lil.php

Installed dns, v1.8 (base)

Built-in pwd

Installed del, v1.7 (base)

Installed dns, v1.8 (base)

Built-in pwd

Installed del, v1.7 (base)

Installed include, v1.18 (base)

Installed code, v1.14 (base)

Interface package  code 1.0

Installed code, v1.14 (minimum)
Interface package  not requested

Module       code
Version      1.14
Base         yes
Minimum      yes
Dependency   include >= 1.16
UI package   code 1.0

Installed ping, v1.10 (base)
    repo.lil.dog > .lil.php

Installed ping, v1.11 (base)
    mirror.example.net > .lil.php

Installed ping, v1.11 (base)
    repo.lil.dog > \sandbox\tmp\extensions.php

Ext  \sandbox\tmp\extensions.php

Ext  .lil.php

code     v1.14 · base
find     v1.7 · base
help     v1.42 · base
install  v1.39 · base
upgrade  v1.12 · base

Removed dns

Removed dns

pwd: built-in command cannot be uninstalled

Removed del

A     142.250.72.14
AAAA  2607:f8b0:4007:80e::200e
MX    10 smtp.google.com
NS    ns1.google.com
TXT   …

missing_module: no version compatible with lil.core.v1

Related commands

A purple command link means that this feature uses another module. Open the linked command to see what it provides and how to install it.

Related documentation