Installation

East India installs from an MSI, as Docker Desktop installs from its own installer. Hyper-V must be enabled, and Windows must be build 26100 or later.

Install

Each release on the Releases page has three MSIs:

MSI What it installs
EastIndiaDesktop-<version>.msi The service, the command line endia.exe and the desktop app. Choose this for a developer's PC.
EastIndiaService-<version>.msi The service and the command line, without the desktop app.
EastIndiaCLI-<version>.msi The command line on its own.

East India Desktop and East India Service each replace the other, because a PC runs one East India service. East India CLI installs beside either. The steps below install East India Desktop; the others install the same way.

  1. Download the MSI. The MSI and the programs in it carry one version, which endia --version prints. It is major.minor.patch, and a later version always replaces an earlier one.

  2. Install it, naming the image folder, which holds East India's Windows discs, disks and virtual machines:

    Administrator prompt on the PC
    msiexec /i EastIndiaDesktop-<version>.msi IMAGEFOLDER=M:\eastindia
    

    Windows asks for administrator rights. Opened this way, or by double-clicking the file, the MSI shows its progress and then a window that says whether the installation succeeded, failed or was cancelled. Without IMAGEFOLDER, the image folder stays as already configured, or is C:\ProgramData\EastIndia\images on a first installation. winget passes the same setting with --custom "IMAGEFOLDER=M:\eastindia".

  3. Sign out and in again. The installer adds you to the eastindia-users group, and Windows reads an account's groups only when it signs in.

  4. Check it. endia version prints the versions of both the command line and the service.

Installer

To change the image folder later, run the MSI again with IMAGEFOLDER set to the new folder: the setup step then uses that folder in place of the configured one.

Updating and uninstalling

Updating is installing a newer MSI. It stops and removes the installed service and programs, installs the new ones, prepares the PC again and starts the service. It keeps your images, records, certificates and the downloaded .NET. An older MSI refuses to install over a newer one.

Uninstalling, from Settings › Apps or with msiexec /x EastIndiaDesktop-<version>.msi, removes the programs, the service and the downloaded .NET. The downloaded .NET stays while East India CLI is still installed. Uninstalling leaves C:\ProgramData\EastIndia, the image folder, the eastindia-users group and East India's Hyper-V account.

A Windows service named TeaToolkit.EastIndia that was created by hand stops the MSI from installing its own. Remove it first, in an administrator prompt, with sc.exe stop TeaToolkit.EastIndia and then sc.exe delete TeaToolkit.EastIndia.

Configuration

Configuration follows Docker's daemon.json. The settings are in C:\ProgramData\EastIndia\config\policy.json, which you edit in an administrator editor. The service reads the file only when it starts, so restart it afterwards with sc.exe stop TeaToolkit.EastIndia and then sc.exe start TeaToolkit.EastIndia. A key the service does not know, or a value out of range, stops it from starting, and the service log names the key. endia info prints every setting in effect, and the desktop app's Settings page lists the main ones under Service, with Open settings file.

User access

Access works as it does in Docker Desktop:

Every authorised user may run every command.