wl forest - Forest management commands


wl forest create [--owner <user>] <storage-template>
wl forest mount []
wl forest unmount []


These are commands to manage forests. A user’s forest is located through their manifests catalog and consists of all the subcontainers of the containers in their manifests catalog (and, recursively, all the subcontainers of them etc.).


wl forest create [<storage-template>]

Bootstrap a new Forest. If –owner option is not specified, it is created for @default-owner. You must have private key of that user in order to use this command.

Arguments: | STORAGE_TEMPLATE storage template used to create Forest containers


This command creates an container in user’s manifest catalog for the Forest. The storage template must contain at least one read-write storage.

After the container is created, the following steps take place:

  1. A link object to manifests catalog container is generated and appended to USER’s manifest.

  2. USER manifest and catalog container’s manifest are copied to the storage from Forest manifests container

--access USER

Allow an additional user or user path access to containers created using this command. By default, those the containers are unencrypted unless at least one USER is passed using this option.

--owner USER, --user USER

Name of the user who owns the Forest. Default: @default-owner

--manifest-local-dir PATH

Set manifests storage local directory. Must be an absolute path. Default: /

wl forest mount [--no-refresh-users] [--list-all] [--save] <forest_name> [<forest_name>...]

Mount a forest given by name or path to manifest. The Wildland system has to be started first, see wl start.

-s, --save

Add the forest containers to default-containers in configuration file, so that they will be mounted at startup.

-c, --with-cache

Create and use a cache storage for all containers in the forest, using the default cache template (see wl set-default-cache). See wl container create-cache for details about caches.

--cache-template <template_name>

Create and use a cache storage for all containers in the forest, using the given template. If used together with –with-cache option, explicit <template_name> takes precedence. See wl container create-cache.

-l, --list-all

During mount, list all the forest containers to be mounted and result of mount (changed/not changed). Can be very long as a forest could contain lot of containers and numerous subcontainers.

-n, --no-refresh-users

Do not attempt to refresh all local user manifests imported through bridges before mount. This can speed up the mount, but can lead to using obsolete user manifests.

wl forest unmount [--path] <forest_name> [<forest_name>...]

Unmount a forest given by name or path to manifest.

--path <path>

Mount path to search for.