- Start Docker
- Enter the following command in the terminal to install the official image:
docker pull illasoft/illa-builder:latest
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 <https://github.com/illacloud/illa/releases/latest/download/illa-x86_64-linux.tar.gz>
# unpack the file
> tar -zxvf illa-x86_64-linux.tar.gz
> cd illa-x86_64-linux
> chmod +x illa
# run the illa cli
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
# 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:
or just execute:
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
- name: envoy.filters.network.http_connection_manager
- name: illa_builder
- "illa.yourdomian.com" # replace with your domain
- name: envoy.filters.http.router
# replace this with your cert file
- name: illa_builder
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.
And log in with the default username and password:
password (self-host mode only).