{
  "id": "ubuntu-resolute",
  "title": "Build and run Redis Open Source on Ubuntu 26.04 (Resolute)",
  "url": "https://redis.io/docs/latest/operate/oss_and_stack/install/build-stack/ubuntu-resolute/",
  "summary": "",
  "tags": [
    "docs",
    "operate",
    "stack",
    "oss"
  ],
  "last_updated": "2026-07-02T11:31:07-05:00",
  "page_type": "content",
  "content_hash": "c913d0552c98fda720f0404efc1560101f55935ca10ae70ee9e74492bdb8b07c",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Follow the steps below to build and run Redis Open Source with all data structures from its source code on a system running Ubuntu 26.04 (Resolute).\n\n\nDocker image used to produce these build notes:\n- ubuntu:26.04\n\nUbuntu 26.04 ships CMake 4.x and clang/LLVM 21 in the default repositories. The Redis modules build requires CMake 3.31.6 or earlier and explicitly passes `-fuse-ld=lld`, so a supported CMake must be pinned with `pip3`, and `lld`, `llvm`, and `libcrypt-dev` must be installed. (`libcrypt-dev` is needed to link the `redisearch` module against `libcrypt`.)"
    },
    {
      "id": "1-install-required-dependencies",
      "title": "1. Install required dependencies",
      "role": "content",
      "text": "Update your package lists and install the necessary development tools and libraries. `lld` and `llvm` are required because the modules build invokes clang with `-fuse-ld=lld` and uses `llvm-ar`; `libcrypt-dev` is required to link `redisearch.so`:\n\n[code example]"
    },
    {
      "id": "2-install-cmake",
      "title": "2. Install CMake",
      "role": "content",
      "text": "Install a supported version of CMake using `pip3` inside a virtual environment (Ubuntu enforces [PEP 668](https://peps.python.org/pep-0668/)) and link it for system-wide access.\n\n\nCMake version 3.31.6 is the latest supported version. Newer versions cannot be used.\n\n\n[code example]"
    },
    {
      "id": "3-download-and-extract-the-redis-source",
      "title": "3. Download and extract the Redis source",
      "role": "content",
      "text": "The Redis source code is available from [the Redis GitHub site](https://github.com/redis/redis/releases). Select the release you want to build and then select the .tar.gz file from the **Assets** drop down menu. You can verify the integrity of these downloads by checking them against the digests in the [redis-hashes GitHub repository](https://github.com/redis/redis-hashes).\n\nCopy the tar(1) file to `/usr/src`.\n\nAlternatively, you can download the file directly using the `wget` command, as shown below.\n\n[code example]\n\nReplace `<version>` with the three-digit Redis release number, for example `8.0.0`.\n\nExtract the source:\n\n[code example]"
    },
    {
      "id": "4-build-redis",
      "title": "4. Build Redis",
      "role": "content",
      "text": "Set the necessary environment variables, and build Redis with TLS and module support:\n\n[code example]"
    },
    {
      "id": "5-optional-verify-the-installation",
      "title": "5. (Optional) Verify the installation",
      "role": "content",
      "text": "Check the built Redis server and CLI versions:\n\n[code example]"
    },
    {
      "id": "6-start-redis",
      "title": "6. Start Redis",
      "role": "content",
      "text": "To start Redis, use the following command:\n\n[code example]\n\nTo validate that the available modules have been installed, run the [`INFO`](https://redis.io/docs/latest/commands/info) command and look for lines similar to the following:\n\n[code example]"
    },
    {
      "id": "7-optional-install-redis-to-its-default-location",
      "title": "7. (Optional) Install Redis to its default location",
      "role": "content",
      "text": "[code example]"
    }
  ],
  "examples": [
    {
      "id": "1-install-required-dependencies-ex0",
      "language": "bash",
      "code": "apt-get update\napt-get install -y sudo\nsudo apt-get install -y --no-install-recommends \\\n    ca-certificates \\\n    wget \\\n    dpkg-dev \\\n    gcc \\\n    g++ \\\n    libc6-dev \\\n    libssl-dev \\\n    libcrypt-dev \\\n    make \\\n    git \\\n    python3 \\\n    python3-pip \\\n    python3-venv \\\n    python3-dev \\\n    unzip \\\n    rsync \\\n    clang \\\n    lld \\\n    llvm \\\n    automake \\\n    autoconf \\\n    libtool",
      "section_id": "1-install-required-dependencies"
    },
    {
      "id": "2-install-cmake-ex0",
      "language": "bash",
      "code": "python3 -m venv /opt/cmake-venv\n/opt/cmake-venv/bin/pip install cmake==3.31.6\nsudo ln -sf /opt/cmake-venv/bin/cmake /usr/local/bin/cmake\ncmake --version",
      "section_id": "2-install-cmake"
    },
    {
      "id": "3-download-and-extract-the-redis-source-ex0",
      "language": "bash",
      "code": "cd /usr/src\nwget -O redis-<version>.tar.gz https://github.com/redis/redis/archive/refs/tags/<version>.tar.gz",
      "section_id": "3-download-and-extract-the-redis-source"
    },
    {
      "id": "3-download-and-extract-the-redis-source-ex1",
      "language": "bash",
      "code": "cd /usr/src\ntar xvf redis-<version>.tar.gz\nrm redis-<version>.tar.gz",
      "section_id": "3-download-and-extract-the-redis-source"
    },
    {
      "id": "4-build-redis-ex0",
      "language": "bash",
      "code": "cd /usr/src/redis-<version>\nexport BUILD_TLS=yes\nexport BUILD_WITH_MODULES=yes\nexport INSTALL_RUST_TOOLCHAIN=yes\nmake -j \"$(nproc)\" all",
      "section_id": "4-build-redis"
    },
    {
      "id": "5-optional-verify-the-installation-ex0",
      "language": "bash",
      "code": "cd /usr/src/redis-<version>\n./src/redis-server --version\n./src/redis-cli --version",
      "section_id": "5-optional-verify-the-installation"
    },
    {
      "id": "6-start-redis-ex0",
      "language": "bash",
      "code": "cd /usr/src/redis-<version>\n./src/redis-server redis-full.conf",
      "section_id": "6-start-redis"
    },
    {
      "id": "6-start-redis-ex1",
      "language": "bash",
      "code": "cd /usr/src/redis-<version>\n./src/redis-cli INFO\n...\n# Modules\nmodule:name=ReJSON,ver=20803,api=1,filters=0,usedby=[search],using=[],options=[handle-io-errors]\nmodule:name=search,ver=21005,api=1,filters=0,usedby=[],using=[ReJSON],options=[handle-io-errors]\nmodule:name=bf,ver=20802,api=1,filters=0,usedby=[],using=[],options=[]\nmodule:name=timeseries,ver=11202,api=1,filters=0,usedby=[],using=[],options=[handle-io-errors]\nmodule:name=RedisCompat,ver=1,api=1,filters=0,usedby=[],using=[],options=[]\nmodule:name=vectorset,ver=1,api=1,filters=0,usedby=[],using=[],options=[]\n...",
      "section_id": "6-start-redis"
    },
    {
      "id": "7-optional-install-redis-to-its-default-location-ex0",
      "language": "bash",
      "code": "cd /usr/src/redis-<version>\nsudo make install",
      "section_id": "7-optional-install-redis-to-its-default-location"
    }
  ]
}