Offline Installers

Offline installers let Enterprise tier users install a runtime environment locally, without the need for a network or internet connection. Installers are available for all Perl, Python, and Ruby projects and are available for the following operating systems as executable installers:

Linux

  • Ubuntu
  • CentOS
  • Debian
  • Fedora
  • Redhat
  • OpenSuse

Windows

  • Windows 10
  • Windows 11
  • Windows Server 2019 and later

Currently, offline installers are not available for macOS. Your offline installers will be available for download through the Download Builds tab of your project page.


Getting an installer created

  1. After creating your project and getting a successful build, let us know that you would like an offline installer created. Send an email to enterprise-support@activestate.com and include the link to the project in your message (copied from your web browser). We will initiate the installer creation and notify you when your offline installer is complete.

This is currently a manual process done by engineers at ActiveState and still uses our secure build system, and the entire process will be integrated into the Platform in the near future.

  1. Once ActiveState has completed building the installer, a “Download Installer” option will appear on the Download Builds tab of your project.
  2. Click the Download button in the “Download Installer” section to download to your local system.

Offline Installers for Windows

windows Download

  1. Running the downloaded file will open a command terminal to complete the installation.

  2. Choose the default installation location shown in the command prompt to install (C:\Users\<username>\AppData\Local\Programs\<project name>), or click down on your keypad and select “Other..” to enter a different installation directory to install your runtime. Windows install

  3. You will be prompted to agree to the runtime installer license agreement, enter y to agree and continue with your installation or n to end the runtime installation.

  4. Once the installation is successful, hit enter to close the command terminal. Your runtime has now been installed on your local system and you can now use your runtime from any new command terminal window.

How to uninstall

To uninstall your project from your local system open a command terminal and locate the folder where the runtime was installed. The default location is C:\Users\<username>\AppData\Local\Programs\<project name>

Enter the uninstall command to remove the installer. You will be asked to confirm your choice, y will continue with the uninstallation and n will end the process.

You will receive a confirmation once your runtime has been uninstalled. Note that uninstalling your offline installer will not remove the containing directory.


Offline installers for Linux

Linux download

  1. Open a command terminal and go to where you have downloaded your offline installer.

  2. Depending on your distribution you may need to enter chmod +x <projectname> to allow executing your offline installer as a program

  3. Run the installer program with the ./<projectname> command

  4. Choose the default installation location shown in the command prompt to install (/home/<username>/.local/share/applications/<projectname>), or click down on your keypad to select “Other..” to enter a different installation directory to install your runtime. Linux install

  5. You will be prompted to agree to the runtime installer license agreement, enter y to agree and continue with your installation or n to end the runtime installation.

  6. Once the installation is successful, hit enter to close the command terminal. Your runtime has now been installed on your local system and is available to use from any new command terminal window.

How to uninstall

To uninstall your project from your local system open a command terminal and locate the folder where the runtime was installed. The default location is /home/<username>/.local/share/applications/<projectname>

Enter the ./uninstall command to remove the installer. You will be asked to confirm your choice, y will continue with the uninstallation and n will end the process.

You will receive a confirmation once your runtime has been uninstalled. Note that uninstalling your offline installer will not remove the containing directory.


Updating your runtime environment

After you have downloaded and installed your runtime, your installer will not be able to automatically update your runtime as you add packages, delete packages, or remediate vulnerabilities.

To update packages in your runtime

  1. Using the Platform go to your Projects tab
  2. Select the project associated with your offline installer
  3. In the Configuration tab of the project
  • To add a package, click the Add Packages button and search for the needed package
    • Click the Add button to add it to your project before clicking Next to save
    • Click Save Changes to save your selection
  • To delete an installed package click the trash bin icon next to the package name
  • To find a different version of the package use the drop-down menu next to the package name to select the appropriate version and wait for the dependencies to be resolved

You can also import packages by uploading them from a requirements file. Details on installing packages from requirements files can be found here.

You can now repeat the process outlined above to request an installer and then you can re-install your runtime to your local Windows or Linux environments.