{
  "schema_version": 2,
  "id": "operate/rs/installing-upgrading/install/customize-install-directories",
  "title": "Customize installation directories",
  "url": "https://redis.io/docs/latest/operate/rs/8.0/installing-upgrading/install/customize-install-directories/",
  "summary": "Customize Redis Software installation directories.",
  "content": "\nWhen you install Redis Software on Red Hat Enterprise Linux, you can customize the installation directories.\n\nThe files are installed in the `redislabs` directory located in the path that you specify.\n\n## Considerations\n\n- When you install with custom directories, the installation does not run as an RPM file.\n\n- If a `redislabs` directory already exists in the path that you specify, the installation fails.\n\n- All nodes in a cluster must be installed with the same file locations.\n\n- Custom installation directories are not supported for databases using Auto Tiering.\n\n- [Configure different mount points for data and log directories](#config-diff-data-log-dirs).\n\n## Specify file locations\n\nYou can specify these file locations:\n\n| Files               | Installer flag | Example parameter | Example file location |\n| ------------------- | -------------- | ----------------- | --------------------- |\n| Binaries files      | --install-dir  | /opt              | /opt/redislabs        |\n| Configuration files | --config-dir   | /etc/opt          | /etc/opt/redislabs    |\n| Data and log files  | --var-dir      | /var/opt          | /var/opt/redislabs    |\n\nThese files are not in the custom directories:\n\n- OS files\n    - /etc/cron.d/redislabs\n    - /etc/firewalld/services\n    - /etc/firewalld/services/redislabs-clients.xml\n    - /etc/firewalld/services/redislabs.xml\n    - /etc/ld.so.conf.d/redislabs_ldconfig.conf.tmpl\n    - /etc/logrotate.d/redislabs\n    - /etc/profile.d/redislabs_env.sh\n    - /usr/lib/systemd/system/rlec_supervisor.service.tmpl\n    - /usr/share/selinux/mls/redislabs.pp\n    - /usr/share/selinux/targeted/redislabs.pp\n\n- Installation reference files\n    - /etc/opt/redislabs/redislabs_custom_install_version\n    - /etc/opt/redislabs/redislabs_env_config.sh\n\nTo specify directories during [installation](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/install-on-linux), include installer flags as [command-line options](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/install-script) when you run the `install.sh` script. For example:\n\n```sh\nsudo ./install.sh --install-dir \u003cpath\u003e --config-dir \u003cpath\u003e --var-dir \u003cpath\u003e\n```\n\n## Configure different mount points for data and log directories {#config-diff-data-log-dirs}\n\nTo configure different mount points for data and log directories, use symbolic links:\n\n1. Create a symbolic link for the data directory:\n\n    ```sh\n    ln -s /var/opt/redislabs/data \u003c/path/to/data/mount/point\u003e\n    ```\n\n1. Create a symbolic link for the log directory:\n\n    ```sh\n    ln -s /var/opt/redislabs/log \u003c/path/to/log/mount/point\u003e\n    ```\n\n## Customize storage paths\n\nWhen you install Redis Software to custom directories, you can specify custom storage paths for persistent and ephemeral storage during [cluster setup](https://redis.io/docs/latest/operate/rs/clusters/new-cluster-setup) or when [adding nodes](https://redis.io/docs/latest/operate/rs/clusters/add-node).\n\n\n1. Specify the custom file location with the `--var-dir` option when you install Redis Software:\n\n    ```sh\n    sudo ./install.sh --var-dir \u003cpath\u003e\n    ```\n\n2. Grant the `redislabs` user access to the custom directories:\n   ```sh\n   $ sudo chown -R redislabs:redislabs /path/to/custom/storage\n   $ sudo chmod -R 755 /path/to/custom/storage\n   ```\n\n3. Confirm the storage path is properly mounted:\n   ```sh\n   $ df -h /path/to/custom/storage\n   $ mount | grep /path/to/custom/storage\n   ```\n\n4. Verify the directory exists and is accessible:\n   ```sh\n   ls -l /path/to/custom/storage\n   ```\n\nFor more information about storage requirements, see [Persistent and ephemeral node storage](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/plan-deployment/persistent-ephemeral-storage).\n\n## Limitations\n\nSeveral Redis Software installation reference files are installed to the directory `/etc/opt/redislabs/` even if you use custom installation directories.\n\nAs a workaround to install Redis Software without using any root directories, do the following before installing Redis Software:\n\n1. Create all custom, non-root directories you want to use with Redis Software.\n\n1. Mount `/etc/opt/redislabs` to one of the custom, non-root directories.\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-08-24T11:13:03-07:00"
}