Skip to content
See Also

APT Manager ​

Debian logo

Kloud Workspace comes pre-configured with a custom APT setup to provide robust and efficient package management.

These configurations are designed to enhance flexibility, reduce unnecessary installations, and prevent the overwriting of user-defined files.

Repository Sources ​

By default, Kloud Workspace is set up with a range of additional repository sources alongside the standard ones. All additional sources are signed with gpg keys to ensure secure and verified package installations.

Disabling Sources ​

If you need to disable any of the repository sources, set the following environment variable:

  • WS_APT_DISABLE_REPOS: Disables specified APT repositories or all repositories.

Custom Sources ​

Add custom repository sources with WS_APT_ADDITIONAL_REPOS. Supply one or more entries separated by semicolons (;).

sh
docker run \
  -e WS_APT_ADDITIONAL_REPOS="deb [signed-by=/custom.gpg] https://custom.package bookworm main" \
  ghcr.io/kloudkit/workspace:v0.0.21

Update Repository Cache ​

You can optionally trigger a package cache update by setting the WS_APT_UPDATE_CACHE environment variable to a either 1 or true.

Update will occur after adding custom sources to ensures that any newly added repositories are immediately available for package installations.

Default Configurations ​

The workspace is configured with several default settings to ensure optimal performance. The primary goals of these configurations are to minimize the image size and maintain the integrity of user-defined files.

Notable configurations include:

  • The --no-install-recommends flag is enabled by default to avoid the installation of recommended but unnecessary packages.
  • APT will avoid overwriting existing files during package installations. This ensures that user-defined settings and files are retained without interruption during updates or installs.

Additional Packages ​

Upon workspace startup, we evaluate the value of WS_APT_ADDITIONAL_PACKAGES environment variable to automate the installation of additional user-defined packages.

WS_APT_ADDITIONAL_PACKAGES can contain one or more space-delimited package names as demonstrated below:

sh
docker run \
  -e WS_APT_ADDITIONAL_PACKAGES="cmake nano" \
  ghcr.io/kloudkit/workspace:v0.0.21

💡 TIP

Some packages are already available as features, which include additional setup steps that enhance their usage and functionality.

We recommend reviewing the available features before opting for manual package installation.

Additional GPG Keys ​

Some third-party repositories require you to trust their signing key. Provide additional keys with WS_APT_ADDITIONAL_GPG_KEYS as one or more space-delimited name:url pairs.

Each key is downloaded at startup and stored in /etc/apt/keyrings/<name>.gpg.

sh
docker run \
  -e WS_APT_ADDITIONAL_GPG_KEYS="mycorp:https://mycorp.com/pubkey.asc extras:http://extras.test/key2.asc" \
  ghcr.io/kloudkit/workspace:v0.0.21

Released under the MIT License