Running Redis on Windows: Setting Up with WSL

04 September 2024

Introduction

As a developer working on a Spring Boot project for a school management system, I quickly realized the need for a fast and efficient caching solution to optimize our application’s performance. Redis, with its reputation as a powerful in-memory data store, was the ideal choice. However, there was a small hitch—I was developing on a Windows machine, and Redis is primarily designed to run on Linux. I needed a way to run Redis on my local development environment without switching to a Linux machine or setting up a virtual machine.

That’s when I discovered the Windows Subsystem for Linux (WSL). WSL allows you to run a Linux environment directly on Windows, enabling you to install and use Linux-based tools, such as Redis, without needing separate hardware or a VM. It seemed like the perfect solution to bridge the gap between my Windows setup and the Linux-native Redis.

Configuring Windows Subsystem for Linux (WSL) for Spring Boot

Here’s how I set up Redis on my Windows machine using WSL:

1. Enable WSL: The first step was to enable WSL on my Windows machine. This was straightforward. I opened PowerShell with administrative privileges and ran the command:

				
					wsl --install
				
			

This command installs WSL and sets up Ubuntu as the default Linux distribution, providing a fully functional Linux environment right inside Windows.

2. Install Ubuntu: Once WSL was installed, the next step was to download Ubuntu from the Microsoft Store. This installation gave me access to the Ubuntu terminal, where I could run Linux commands and install software packages just like on any other Linux system.

3. Install Redis on Ubuntu (WSL): With Ubuntu up and running in WSL, I proceeded to install Redis. This was a breeze, thanks to the simplicity of Linux package management. I opened the Ubuntu terminal and ran the following commands:

				
					sudo apt update
sudo apt install redis-server
				
			

4. Start Redis: After installation, I started the Redis server using:

				
					sudo service redis-server start
				
			

5. Connect Redis to Spring Boot: With Redis running on WSL, I could connect it to my Spring Boot application just like I would on a native Linux machine. The application.properties configuration remained the same, pointing to the Redis instance running on localhost.

				
					spring.redis.host=localhost
spring.redis.port=6379
				
			

Final Thoughts

Setting up Redis on Windows using WSL is a great way to take advantage of Linux-based tools and environments without leaving the comfort of your Windows machine. This approach not only allows you to run Redis natively but also opens up a world of possibilities for using other Linux-based tools and services.

While the initial setup might seem daunting if you’re not familiar with WSL, once you have it configured, running Redis becomes straightforward and efficient. The performance benefits of Redis combined with the flexibility of WSL make this a powerful combination for development and testing purposes on a Windows machine.

I hope this helped you understand how to set up Redis on Windows using WSL. Whether you’re using Redis for caching, session management, or other purposes, having it run smoothly on your development machine can significantly improve your workflow. If you have any questions or run into issues, feel free to reach out—I’m here to help! Happy coding!

References

Muhammad Aaliyan Khan

Software Engineer at Qavi Technologies