Skip to main content

Self-hosted deployment


  1. Start Docker
  2. Enter the following command in the terminal to install the official image:

docker pull illasoft/illa-builder:latest

docker run -p80:2022 illasoft/illa-builder:latest

80 is the port, you can change it if it is already in use. After the execution is complete, you can access it via https://[localhost]:[80].


Download ILLA CLI and deploy

If you have Rust installed, you can easily build+install the latest ILLA CLI release with cargo:

cargo install illa

illa deploy --self --port=10000

The cargo tool will complete downloading the ILLA CLI with its source dependencies, build and install it into the cargo bin path so that we can run it. Once installed, you can run the ILLA CLI with the illa command.

Alternatively, you can just download the ILLA CLI for your operating system here:

If you do download from the above links, the steps are slightly different compared to downloading the ILLA CLI from cargo . After downloading the CLI, you will have to make it executable. Let’s take the illa-linux for example:

# download illa cli binary file
> wget <>

# unpack the file
> tar -zxvf illa-x86_64-linux.tar.gz

> cd illa-x86_64-linux

> chmod +x illa

# run the illa cli
> ./illa

Checking the prerequisites of self-hosted installation

These ports 5432, 9999 and 8000 should remain for the ILLA Builder

The following command will check the prerequisites of self-hosted installation on your operating system:

> illa doctor

Deploying ILLA Builder

Once the ILLA CLI has been installed, you can run a self-hosted or cloud installation.

You can simply deploy a self-hosted ILA Builder by running the following command:

# the port which ILLA Builder can be accessed on can be changed
# the <SERVER_ADDRESS> should be your cloud server public ip, default localhost
> illa deploy --self --port=10000 --server-addr=<SERVER_ADDRESS>

Now, you can access the ILLA Builder: http://localhost:10000

Updating ILLA Builder

To update the ILLA Builder with the latest docker images, use the following command:

> illa update --self

Other operations

# list the ILLA Builder
> illa list --self

# stop the ILLA Builder
> illa stop --self

# remove the ILLA Builder
> illa remove --self

# forced removal of the running ILLA Builder and persistent data
> sudo illa remove --force --self --data

# restart the ILLA Builder
> illa restart --self

# help information
> illa help



Build illa all-in-one image and run it by k8s on your machine. You can check out the scripts file in the scripts folder for more details.


We highly recommended deploying with our auto-deploy tools illa-cli.

And for the moment we do not support Apple Silicon M1 (darwin-arm64 arch).

Run with an official slim image

Install GNU make and type:

make deploy

or just execute:

/bin/bash scripts/

this command will pull illasoft official all-in-one image and deploy it on your Kubernetes cluster.

For Database Persistent Storage

Edit illa-builder.yaml, and add your IAAS persistent storage config on it.

For HTTPS Config

You can route the NodePort to your Kubernetes cluster ingress gateway and rewrite to 443 port, and add https cert in your ingress gateway.

Or, you can deploy an ingress gateway manually into your Kubernetes server, config like this:

- name: https_listener
port_value: 443
- filters:
- name:
stat_prefix: https_listener
name: local_route
- name: illa_builder
- "" # replace with your domain
- match:
prefix: "/"route:
cluster: illa_builder
- name: envoy.filters.http.router
name: envoy.transport_sockets.tls
# replace this with your cert file
- certificate_chain:
filename: /your-cert-folder/fullchain.pem
filename: /your-cert-folder/privkey.pem

- name: illa_builder
lb_policy: ROUND_ROBIN
connect_timeout: 10s
cluster_name: illa_builder
- lb_endpoints:
- endpoint:
address: illa-builder
port_value: 80

Quickly deploy

You can deploy ILLA in a remarkably fast way, please follow the instructions below:

First, please download this docker file to your computer, then run the following code.

cd docker;
/bin/bash ./scripts/;

And log in with the default username and password:

Username: root

Password: password (self-host mode only).