--- title: "How do I install LumiCode?" slug: "how-do-i-install-lumicode" tags: ["LumiCode", "luminesce "] updated: 2026-10-26T13:34:41Z published: 2026-10-26T13:34:41Z canonical: "support.lusid.com/how-do-i-install-lumicode" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.lusid.com/llms.txt > Use this file to discover all available pages before exploring further. # How do I install LumiCode? LumiCode takes only a few minutes to install. After that, it tells you when a new version is available, you can update it with a single command, and you can use it to download every other Luminesce binary you need. This article shows you how to install LumiCode and sign in for the first time. ## Prerequisites - The **.NET 10 SDK**, on any operating system that .NET 10 supports (Windows, macOS or Linux). LumiCode installs as a .NET tool, so you need the SDK, not just the runtime. Run `dotnet --list-sdks` to check which SDKs you have. - Two licences for your LUSID domain, which you can request from FINBOURNE: - `honeycomb-binary-downloads`, which lets you download any Luminesce binary. - `honeycomb-binary-download-lumi-code`, which lets you download LumiCode. - Permission to download LumiCode. Users with the `lusid-administrator` role have it by default. Other users need the feature policy in Appendix A. - A modern terminal. LumiCode works best in iTerm2 on macOS and Windows Terminal on Windows. In macOS's Terminal.app and the old Windows console, you can't open LumiCode's links and some symbols may not display. LumiCode shows a tip when it starts in one of these terminals. See [How do I set up my terminal for LumiCode?](/v1/docs/how-do-i-set-up-my-terminal-for-lumicode) ## Method ### Step 1: Download LumiCode Use Swagger for this download You can only download LumiCode the first time through Swagger, as described below. The [DownloadBinary page in the API reference](https://www.lusid.com/docs/api/luminesce/endpoints/binary-downloading/DownloadBinary) can't download the file for you. Once LumiCode is installed, you won't need Swagger again: LumiCode updates itself, and downloads any other Luminesce binary for you. 1. Navigate to `https://<your-domain>.lusid.com/honeycomb/swagger/index.html`, where `<your-domain>` is the name of your LUSID domain, for example `acmecorp`. 2. Find the **DownloadBinary** API and select **Try it out**. 3. Set `type` to `LumiCode` and leave `version` blank to get the latest version. Then select **Execute**. ![Image](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-X7U81VPV.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A26%3A42Z&se=2026-11-18T20%3A26%3A42Z&sr=b&sp=r&sig=5qWZsC9iyb%2FRWuNKsDzkfUrgvXoG7msxGn4vUuq%2Bjfw%3D) 1. In the response, select **Download file**. Your browser saves a `.nupkg` file to its usual download folder. ![Image](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-WZZXDRM6.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A26%3A42Z&se=2026-11-18T20%3A26%3A42Z&sr=b&sp=r&sig=ZwH%2FHIw8GfTshmmRckvTR%2BtSg%2BMUyBWNH7L9f%2FYEKtg%3D) If the download fails If you see a message saying you are not allowed to download LumiCode, the message also lists what you're missing: licences for your domain, an entitlement for your user, or both. See Prerequisites. ### Step 2: Install LumiCode In a terminal, run the following command, replacing `<folder>` with the folder that contains the downloaded `.nupkg` file: ```bash dotnet tool install --global Finbourne.Luminesce.Lumi --add-source ``` This installs the `lumi` command in the .NET tools folder: - Windows: `%USERPROFILE%\.dotnet\tools` - macOS and Linux: `$HOME/.dotnet/tools` If your terminal can't find `lumi`, add that folder to your `PATH`, then open a new terminal. ### Step 3: Sign in and run LumiCode Sign in to your LUSID domain: ```plaintext lumi login --domain=.lusid.com ``` Your browser opens so that you can sign in. LumiCode saves your sign-in as a profile, so you only need to do this once. ![Image](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-XQMGQZMF.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A26%3A42Z&se=2026-11-18T20%3A26%3A42Z&sr=b&sp=r&sig=7W%2FGjJuGendJ4LVZNHLsLjb4u1W%2FZdE7%2FMNRIGoNn8g%3D) Then run `lumi` with no arguments to start an interactive session. To see every command and option, run `lumi --help`: ## Updating LumiCode Once a day, LumiCode checks whether a newer version is available and tells you if it has new features. Use `/whats-new` to see what has changed and `/update` to install the latest version. To stop these checks, use `/set update-check off`. ![Image](https://cdn.document360.io/d575ad81-c0ed-4980-bbd1-d59ac5c3de82/Images/Documentation/image-NJIYIBR8.png?sv=2026-02-06&spr=https&st=2026-11-18T19%3A26%3A42Z&se=2026-11-18T20%3A26%3A42Z&sr=b&sp=r&sig=fMEyvAlITPJ%2FVvpffH%2FEANxOvPgEkC2spSEgy%2Fox9sg%3D) On Windows, LumiCode can't replace itself while it's running. Instead, `/update` downloads the new version and shows you the command to run after you exit. ## Downloading other Luminesce binaries Once LumiCode is installed, use `/binaries` to download any other Luminesce binary, such as provider hosts and drivers, without going back to Swagger. Choose the binary, the version (the latest by default) and the folder to save it to. Each binary needs its own licence and entitlement. ## Troubleshooting If links don't open, symbols show as boxes, Shift+Enter runs the query instead of adding a new line, or ⌘C doesn't copy in the editor, your terminal needs a setting or two changed. See [How do I set up my terminal for LumiCode?](/v1/docs/how-do-i-set-up-my-terminal-for-lumicode) ## Appendix A: Allowing non-administrative users to download LumiCode Once FINBOURNE grants the licences, users with the `lusid-administrator` role can download LumiCode by default. To let other users download it, [create a feature policy](https://support.lusid.com/docs/how-do-i-create-a-feature-policy) with the following JSON, assign the policy to a role, and then assign the role to each user: ```json {    "description": "User can download LumiCode",    "applications": [        "Honeycomb"    ],    "grant": "Allow",    "selectors": [        {            "idSelectorDefinition": {                "identifier": {                    "code": "LumiCode",                    "scope": "Honeycomb"                },                "actions": [                    {                        "scope": "Honeycomb",                        "activity": "DownloadBinary",                        "entity": "Feature"                    }                ],                "name": "LumiCode binary",                "description": "User can download LumiCode"            }        }    ],    "when": {        "activate": "2023-01-01T00:00:00.0000000+00:00",        "deactivate": "9999-12-31T23:59:59.9999999+00:00"    } } ``` ## Related - [LumiCode](/introduction-to-lumicode.md)