---
title: "Advanced installation options"
url: "https://axoflow.com/docs/axoflow/0.86/provisioning/axorouter/linux/advanced-options/"
last_modified: "2026-06-09T14:22:16+02:00"
---

> For the complete documentation index, see [llms.txt](https://axoflow.com/docs/axoflow/0.86/llms.txt).

# Advanced installation options

When installing AxoRouter, you can set a number of advanced options if needed for your environment. Setting the advanced options in the AxoConsole automatically updates the one-liner command that you can copy and run.

![Advanced deployment options](https://axoflow.com/docs/axoflow/0.86/provisioning/axorouter/linux/advanced-options/provisioning-advanced-options_hu_fd7348c50d7089b7.webp)

Alternatively, before running the one-liner you can use one of the following methods:

- Set the related environment variable for the option. For example:

  ```shell
  export AXO_USER=syslogng
  export AXO_GROUP=syslogng
  ```
- Set the related URL parameter for the option. For example:

  ```shell
  curl -fLsH 'X-AXO-TOKEN:random-generated' 'https://<your-tenant-id>.cloud.axoflow.io/setup.sh?type=AXOROUTER&platform=LINUX&user=syslogng&group=syslogng' | sh
  ```

## Proxy settings

Use the [**HTTP proxy**](https://axoflow.com/docs/axoflow/0.86/provisioning/axorouter/linux/advanced-options/index.md#http-proxy), **HTTPS proxy**, **No proxy** parameters to configure HTTP proxy settings for the installer. To avoid using the proxy for the Axolet service, enable the [**Avoid proxy**](https://axoflow.com/docs/axoflow/0.86/provisioning/axorouter/linux/advanced-options/index.md#avoid-proxy) parameter as well. Lowercase variable names are preferred because they work universally.

## Installation options

You can pass the following parameters to the installation script as environment variables, or as URL parameters.

> **Note:**
> Running the provisioning command with `sudo` would mask environment variables of the calling shell. Either start the whole procedure from a root shell, or let the install script call sudo when it needs to. In other words: don’t add the `sudo` command to the provisioning command.

### External image pull

|  |  |
| --- | --- |
| Default value: | `true` |
| Environment variable | `AXO_EXTERNAL_IMAGE_PULL` |
| URL parameter | `external_image_pull` |

*Description*: If `true`, the installation script downloads the images from the central Axoflow repository. If `false`, the script downloads the images from the AxoConsole host. This is useful when deploying AxoRouters in [airgapped environments](https://axoflow.com/docs/axoflow/0.86/deploy/airgapped/index.md).

### AxoRouter capabilities

|  |  |
| --- | --- |
| Default value: | `CAP_NET_BIND_SERVICE CAP_NET_BROADCAST CAP_NET_RAW CAP_SYSLOG CAP_BPF` |
| Environment variable | `AXO_AXOROUTER_CAPS` |
| URL parameter | `axorouter_caps` |

*Description*: Capabilities added to the AxoRouter container.

### AxoRouter config mount path

|  |  |
| --- | --- |
| Default value: | `/etc/axorouter/user-config` |
| Environment variable | `AXO_AXOROUTER_CONFIG_MOUNT_INSIDE` |
| URL parameter | `axorouter_config_mount_inside` |

*Description*: Mount path for custom user configuration.

### AxoRouter image override

|  |  |
| --- | --- |
| Default value: | `us-docker.pkg.dev/axoflow-registry-prod/axoflow/axorouter` |
| Environment variable | `AXO_IMAGE` |
| URL parameter | `image` |

*Description*: Deploy the specified AxoRouter image.

### Extra container arguments

|  |  |
| --- | --- |
| Default value: | empty string |
| Environment variable | `AXO_PODMAN_ARGS` |
| URL parameter | `extra_args` |

*Description*: Additional arguments passed to the AxoRouter container.

### Image repository

|  |  |
| --- | --- |
| Default value: | `us-docker.pkg.dev/axoflow-registry-prod/axoflow/axorouter` |
| Environment variable | `AXO_IMAGE_REPO` |
| URL parameter | `image_repo` |

*Description*: Deploy AxoRouter from a custom image repository.

### Image version

|  |  |
| --- | --- |
| Default value: | Current Axoflow version |
| Environment variable | `AXO_IMAGE_VERSION` |
| URL parameter | `image_version` |

*Description*: Deploy the specified AxoRouter version.

### Package format

|  |  |
| --- | --- |
| Default value: | `auto` |
| Available values: | `auto`, `dep`, `rpm`, `tar`, `none` |
| Environment variable | `AXO_INSTALL_PACKAGE` |
| URL parameter | `install_package` |

*Description*: File format of the installer package.

### Start router

|  |  |
| --- | --- |
| Default value: | `true` |
| Available values: | `true`, `false` |
| Environment variable | `AXO_START_ROUTER` |
| URL parameter | `start_router` |

*Description*: Start AxoRouter after installation.

## Axolet parameters

### API server host

|  |  |
| --- | --- |
| Default value: |  |
| Environment variable |  |
| URL parameter | `api_server_host` |

*Description*: Override the host part of the API endpoint for the host.

### Avoid proxy

|  |  |
| --- | --- |
| Default value: | `false` |
| Available values: | `true`, `false` |
| Environment variable | `AXO_AVOID_PROXY` |
| URL parameter | `avoid_proxy` |

*Description:* If set to `true`, the value of the [`*_proxy`](https://axoflow.com/docs/axoflow/0.86/provisioning/axorouter/linux/advanced-options/index.md#proxy-settings) variables will only be used for downloading the installer, but not for the `axolet` service itself. If set to `false`, the Axolet service will use the variables from the installer.

### Axolet capabilities

|  |  |
| --- | --- |
| Default value: | `CAP_SYS_PTRACE CAP_SYS_CHROOT` |
| Available values: | Whitespace-separated list of capability names with `CAP_` prefix. |
| Environment variable | `AXO_CAPS` |
| URL parameter | `caps` |

*Description:* Ambient Linux capabilities the `axolet` service will use.

### Configuration directory

|  |  |
| --- | --- |
| Default value: | `/etc/axolet` |
| Environment variable | `AXO_CONFIG_DIR` |
| URL parameter | `config_dir` |

*Description*: The directory where the configuration files are stored.

### HTTP proxy

|  |  |
| --- | --- |
| Default value: | empty string |
| Environment variable | `AXO_HTTP_PROXY` |
| URL parameter | `http_proxy` |

*Description*: Use a proxy to access AxoConsole from the host.

### HTTPS proxy

|  |  |
| --- | --- |
| Default value: | empty string |
| Environment variable | `AXO_HTTPS_PROXY` |
| URL parameter | `https_proxy` |

*Description*: Use a proxy to access AxoConsole from the host.

### Initial labels

|  |  |
| --- | --- |
| Default value: | ‘product=axorouter,vendor=axoflow’ |
| Environment variable | `AXO_INITIAL_LABELS` |
| URL parameter | `initial_labels` |

*Description*: Comma-separated list of `key=value` labels. These labels will be suggested for the host when you add the source to AxoConsole. For example, `product=windows,team=windows,vendor=microsoft`

### No proxy

|  |  |
| --- | --- |
| Default value: | empty string |
| Environment variable | `AXO_NO_PROXY` |
| URL parameter | `no_proxy` |

*Description*: Comma-separated list of hosts that shouldn’t use proxy to access AxoConsole from the host.

### Overwrite config

|  |  |
| --- | --- |
| Default value: | `false` |
| Available values: | `true`, `false` |
| Environment variable | `AXO_CONFIG_OVERWRITE` |
| URL parameter | `config_overwrite` |

*Description:* If set to `true`, the configuration process will overwrite existing configuration (`/etc/axolet/config.json`). This means that the agent will get a new GUID and it will require approval on the AxoConsole.

### Service group

|  |  |
| --- | --- |
| Default value: | `root` |
| Environment variable | `AXO_GROUP` |
| URL parameter | `group` |

*Description:* Name of the group and Axolet will be running as. It should be either `root` or the group `syslog-ng` is running as.

### Service user

|  |  |
| --- | --- |
| Default value: | `root` |
| Environment variable | `AXO_USER` |
| URL parameter | `user` |

*Description:* Name of the user Axolet will be running as. It should be either `root` or the user `syslog-ng` is running as. See also [Run axolet as non-root](https://axoflow.com/docs/axoflow/0.86/provisioning/axolet/non-root/index.md).

### Start service

|  |  |
| --- | --- |
| Default value: | `true` |
| Available values: | `true`, `false` |
| Environment variable | `AXO_START` |
| URL parameter | `start` |

*Description:* Start axolet agent at the end of installation. Use false for preparing golden images. In this case `axolet` will generate a new GUID on the first boot after cloning the image.

## WEC parameters

These parameters are related to the Windows Event Collector server that can be run on AxoRouter. For details, see [Windows Event Collector (WEC)](https://axoflow.com/docs/axoflow/0.86/data-sources/wec/index.md).

### WEC image override

|  |  |
| --- | --- |
| Default value: | `` |
| Environment variable | `WEC_IMAGE` |
| URL parameter | `wec_image` |

*Description*: Deploy the specified WEC image.

### WEC image repository

|  |  |
| --- | --- |
| Default value: | `us-docker.pkg.dev/axoflow-registry-prod/axoflow/axorouter-wec` |
| Environment variable | `AXO_WEC_IMAGE_REPO` |
| URL parameter | `wec_image_repo` |

*Description*: Deploy the Windows Event Collector server from a custom image repository.

### WEC image version

|  |  |
| --- | --- |
| Default value: | Current Axoflow version |
| Environment variable | `AXO_WEC_IMAGE_VERSION` |
| URL parameter | `wec_image_version` |

*Description*: Deploy the specified Windows Event Collector server version.

## `axorouter-resolver` parameters

These parameters are related to the resolver service that can be run on AxoRouter.

### Enable axorouter-resolver

|  |  |
| --- | --- |
| Default value: | `true` |
| Available values: | `true`, `false` |
| Environment variable | `AXORESOLVER_ENABLED` |
| URL parameter | `axoresolver_enabled` |

*Description*: Install `axorouter-resolver` for this AxoRouter deployment.

### axorouter-resolver image

|  |  |
| --- | --- |
| Default value: |  |
| Environment variable | `AXORESOLVER_IMAGE` |
| URL parameter | `axoresolver_image` |

*Description*: Deploy the specified `axorouter-resolver` image.

### axorouter-resolver image repository

|  |  |
| --- | --- |
| Default value: | `us-docker.pkg.dev/axoflow-registry-prod/axoflow/axoresolver` |
| Environment variable | `AXORESOLVER_IMAGE_REPO` |
| URL parameter | `axoresolver_image_repo` |

*Description*: Deploy the `axorouter-resolver` from a custom image repository.

### axorouter-resolver image version

|  |  |
| --- | --- |
| Default value: | Current Axoflow version |
| Environment variable | `AXORESOLVER_IMAGE_VERSION` |
| URL parameter | `axoresolver_image_version` |

*Description*: Deploy the specified `axorouter-resolver` version.

### axorouter-resolver persistence directory

|  |  |
| --- | --- |
| Default value: | `${AXOROUTER_PERSIST_MOUNT}/axoresolver` |
| Environment variable | `AXORESOLVER_PERSIST_DIR` |
| URL parameter |  |

*Description*: Directory where `axorouter-resolver` stores persistent data.

### axorouter-resolver configuration directory

|  |  |
| --- | --- |
| Default value: | `/etc/axorouter/axoresolver` |
| Environment variable | `AXORESOLVER_CONFIG_DIR` |
| URL parameter |  |

*Description*: Directory where `axorouter-resolver` configuration files are stored.

### axorouter-resolver environment file

|  |  |
| --- | --- |
| Default value: | `/etc/axorouter/axoresolver.env` |
| Environment variable | `AXORESOLVER_ENV_FILE` |
| URL parameter |  |

*Description*: Path to the `axorouter-resolver` environment file.

### axorouter-resolver configuration file

|  |  |
| --- | --- |
| Default value: | `${AXORESOLVER_CONFIG_DIR}/resolvers.json` |
| Environment variable | `AXORESOLVER_CONFIG_FILE` |
| URL parameter |  |

*Description*: Path to the `axorouter-resolver` configuration file.

### axorouter-resolver socket path

|  |  |
| --- | --- |
| Default value: | `${AXORESOLVER_PERSIST_DIR}/axoresolver.sock` |
| Environment variable | `AXORESOLVER_SOCKET_PATH` |
| URL parameter |  |

*Description*: Path to the `axorouter-resolver` socket file.

### axorouter-resolver cache file

|  |  |
| --- | --- |
| Default value: | `${AXORESOLVER_PERSIST_DIR}/axoresolver-cache.json` |
| Environment variable | `AXORESOLVER_CACHE_FILE` |
| URL parameter |  |

*Description*: Path to the `axorouter-resolver` cache file.

### axorouter-resolver cache write interval

|  |  |
| --- | --- |
| Default value: | `10` |
| Environment variable | `AXORESOLVER_CACHE_WRITE_INTERVAL` |
| URL parameter |  |

*Description*: Interval for writing the cache to disk. If you don’t specify the unit, it’s treated as seconds: `10` is the same as `10s`. You can use other units as well, for example, `m` for minutes.

### axorouter-resolver log level

|  |  |
| --- | --- |
| Default value: | `INFO` |
| Environment variable | `AXORESOLVER_LOG_LEVEL` |
| URL parameter |  |

*Description*: Log level for `axorouter-resolver`.

## AxoStore parameters

These parameters are related to the AxoStore that can be run on AxoRouter. For details, see [Storage](https://axoflow.com/docs/axoflow/0.86/storage/index.md).

### AxoStore enable

|  |  |
| --- | --- |
| Default value: | `true` |
| Available values: | `true`, `false` |
| Environment variable | `AXO_AXOSTORE_ENABLED` |
| URL parameter | `axostore_enabled` |

*Description*: Install AxoStore for this AxoRouter deployment.

### AxoStore Image repository

|  |  |
| --- | --- |
| Default value: | `us-docker.pkg.dev/axoflow-registry-prod/axoflow/axostore` |
| Environment variable | `AXO_AXOSTORE_IMAGE_REPO` |
| URL parameter | `axostore_image_repo` |

*Description*: Deploy the AxoStore from a custom image repository.

### AxoStore Image version

|  |  |
| --- | --- |
| Default value: | Current Axoflow version |
| Environment variable | `AXO_AXOSTORE_IMAGE_VERSION` |
| URL parameter | `axostore_image_version` |

*Description*: Deploy the specified AxoStore version.

### AxoStore storage directory

|  |  |
| --- | --- |
| Default value: | `/var/lib/clickhouse` |
| Environment variable | `AXOSTORE_MOUNT` |
| URL parameter | N/A |

*Description*: The directory where the AxoStores are stored. Make sure that there’s sufficient disk space, especially for long-time retention and/or high data volume.