Redis Service
Run and operate a persistent, password-protected Redis service.
The Redis service runs the official Redis Docker image with persistent storage, a generated password, connection URLs, optional browser administration tools, and resource controls.
Create a Redis service
- Open a project and select New Service.
- Select Redis and enter a service name.
- Optionally set the password and Docker image.
- Create the service and wait for it to start.
- Open Credentials and copy the internal connection URL into the application that needs Redis.
When the password is omitted, Easypanel generates one. Leaving the image empty uses Easypanel's default official Redis image.
Overview
The overview provides start, stop, logs, notes, and destroy actions. Its Shell
menu can open Bash or redis-cli using the service password.
The page also shows runtime metrics, recent logs, detected errors, and two optional administration tools:
- Redis Commander provides a Redis-focused browser interface.
- DbGate provides a general database browser.
Enable a tool only when needed and disable it afterward. Easypanel gives each tool a generated access token and a dedicated domain. Redis Commander may take up to two minutes to start after it is enabled.
Credentials
The Credentials tab shows:
- the fixed user
defaultand service password; - internal host and port
6379; - internal connection URL;
- external host, port, and connection URL when the service is exposed.
Services in the same Easypanel project should use the internal connection URL. The internal host is derived from the project and service names and is reachable on the private service network.
Select Edit to change the password. Easypanel redeploys Redis and connected Redis Commander or DbGate tools. Update every application that uses the old password.
A Redis connection URL contains the password. Store it as an environment variable and do not include it in source control or logs.
Expose
Redis is private by default. The Expose tab publishes it on the server so that an external client can connect. Saving the exposed port restarts the service and adds external values to the Credentials tab.
Prefer the internal connection for applications hosted in Easypanel. Publicly exposed Redis instances are frequent attack targets. If remote access is unavoidable, restrict the port to trusted addresses with the server or provider firewall and use a unique published port.
Persistence and backups
Redis stores persistent files in its data directory, but the Redis service does not have the scheduled Backups tab available to the other database service types. Use an external backup process appropriate for the configured Redis persistence mode, and test restoration before relying on it.
Do not treat Redis as disposable when it contains queues, sessions, or data that cannot be reconstructed.
Resources
Configure memory reservations and limits in MB, and CPU reservations and limits
in cores. Set a value to 0 for unlimited resources. Saving these settings
restarts the service.
Coordinate the container memory limit with Redis memory and eviction settings. If the container limit is lower than the working set, the operating system can terminate Redis instead of allowing Redis to apply its configured eviction policy.
Advanced
Advanced settings can override the Docker image and command and add environment
variables using .env syntax. Saving Advanced settings redeploys Redis.
The Easypanel deployment passes the service password to the Redis image. Use a command override only when you understand how the image consumes that configuration and starts the Redis server.
Image and command changes can disable authentication, persistence, or startup. Take a verified copy of important Redis data before changing the image version or persistence settings.
Data and deletion
Redis stores its data on the server at:
/etc/easypanel/projects/[project]/[service]/dataThe directory is mounted at /data in the container. Destroying the service
permanently removes its data and configuration. Export important data before
confirming deletion.