Offline installation
To perform a MicroK8s environment creation when the target servers are offline or airgapped, some prerequisite configuration is required. This includes downloading the MicroK8s installation files for the version you wish to install, the related addon images, and the Portainer Agent image.
This is advanced functionality and assumes working knowledge of the Linux command line. If you do not explicitly need to perform offline or airgapped installs of MicroK8s environments we recommend following the standard procedure.
Preparation
As with a standard MicroK8s provision, Portainer requires SSH access to the servers that are being provisioned. Within this SSH user's home directory, create a directory named microk8s
, and within that a subdirectory named images
. This is where Portainer expects the MicroK8s files to be for an offline installation. For example:
Once you have completed the below steps, ensure that the above directory (and files within) are owned by the SSH user that Portainer will connect with to perform the installation.
You will also want to ensure you have snap
installed as this is required for the MicroK8s installation. Modern versions of Ubuntu should come with snap
preinstalled, but you can refer to the snap documentation if you need to install it separately.
Download MicroK8s
Next you will need to download the MicroK8s installation files. The below example does so for version 1.27 - if you need to use a different version, adjust the command accordingly.
This should result in 4 files being downloaded - an .assert
file and a .snap
file for both microk8s
and core20
. For example (your exact filenames may differ):
Move these downloaded files into the microk8s
directory you created earlier, renaming them as you go to the filenames expected by Portainer:
Download required images
To support the necessary addons for MicroK8s, you will need to pre-download the Docker images used to provision the addons. The exact addons and versions differ depending on the version of MicroK8s you are installing, and can be found at the following URL in the MicroK8s repository (adjust the version number to suit):
For example, for 1.27 you will need the following:
In addition, you will need the Portainer Agent image - replace {PORTAINER_SERVER_VERSION}
with the version number that matches your Portainer Server installation (for example, 2.20.3
):
You may also want to pre-download the kubectl-shell
image if you wish to use the kubectl shell functionality within Portainer:
One way to pre-download these images is to use an installed version of Docker to pull the images and then save them in the path and filename that is expected. For example:
This will need to be done for each image needed. A simple bash script, once populated with the images in a list, could perform this:
Copy the files to all nodes
If you are installing a multi-node cluster, the $HOME/microk8s
directory and files within must be on all nodes in the cluster at the same path. While doing this, ensure that the directory and files have the correct owner (the SSH user that Portainer will use to connect to the nodes).
Begin the installation
You are now ready to follow the standard procedure in Portainer for creating a MicroK8s cluster, but with the Offline install toggle enabled.
![](https://docs.portainer.io/~gitbook/image?url=https%3A%2F%2F3124200557-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FSnGaCQxx2ODexfYYKEez%252Fuploads%252FVyHveZRfsaaYM8Z8Zr9l%252F2.20.3-environments-add-k8s-create-offline-toggle.png%3Falt%3Dmedia%26token%3D2654f8f7-0fe3-43a4-9903-a013c44cbe2b&width=768&dpr=4&quality=100&sign=2684415e&sv=1)
Last updated