Collapse navigation tree

Collapse

Install 25.3 Beta

Redpanda beta versions provide users the opportunity to test and share feedback on new features before they’re finalized in general availability. Beta versions, like v25.3.5, are published to redpanda-unstable as release candidate (RC) builds. RC builds are not recommended for production use.

To install the beta version, select your environment.

  • Docker

  • Linux

  • macOS

  • Kubernetes

  1. Pull the latest RC build from Docker Hub:

    docker pull docker.redpanda.com/redpandadata/redpanda-unstable:v25.3.5

  2. Create a Docker Compose file with the beta version:

    Reveal the YAML content 
    name: redpanda-quickstart
networks:
  redpanda_network:
    driver: bridge
volumes:
  redpanda-0: null
services:
  redpanda-0:
    command:
      - redpanda
      - start
      - --kafka-addr internal://0.0.0.0:9092,external://0.0.0.0:19092
      # Address the broker advertises to clients that connect to the Kafka API.
      # Use the internal addresses to connect to the Redpanda brokers'
      # from inside the same Docker network.
      # Use the external addresses to connect to the Redpanda brokers'
      # from outside the Docker network.
      - --advertise-kafka-addr internal://redpanda-0:9092,external://localhost:19092
      - --pandaproxy-addr internal://0.0.0.0:8082,external://0.0.0.0:18082
      # Address the broker advertises to clients that connect to the HTTP Proxy.
      - --advertise-pandaproxy-addr internal://redpanda-0:8082,external://localhost:18082
      - --schema-registry-addr internal://0.0.0.0:8081,external://0.0.0.0:18081
      # Redpanda brokers use the RPC API to communicate with each other internally.
      - --rpc-addr redpanda-0:33145
      - --advertise-rpc-addr redpanda-0:33145
      # Tells Seastar (the framework Redpanda uses under the hood) to use 1 core on the system.
      - --smp 1
      # The amount of memory to make available to Redpanda.
      - --memory 1G
      # Mode dev-container uses well-known configuration properties for development in containers.
      - --mode dev-container
      # enable logs for debugging.
      - --default-log-level=debug
    image: docker.redpanda.com/redpandadata/redpanda-unstable:v25.3.5
    container_name: redpanda-0
    volumes:
      - redpanda-0:/var/lib/redpanda/data
    networks:
      - redpanda_network
    ports:
      - 18081:18081
      - 18082:18082
      - 19092:19092
      - 19644:9644
  console:
    container_name: redpanda-console
    image: docker.redpanda.com/redpandadata/console:v3.3.1
    networks:
      - redpanda_network
    entrypoint: /bin/sh
    command: -c 'echo "$$CONSOLE_CONFIG_FILE" > /tmp/config.yml; /app/console'
    environment:
      CONFIG_FILEPATH: /tmp/config.yml
      CONSOLE_CONFIG_FILE: |
        kafka:
          brokers: ["redpanda-0:9092"]
          schemaRegistry:
            enabled: true
            urls: ["http://redpanda-0:8081"]
        redpanda:
          adminApi:
            enabled: true
            urls: ["http://redpanda-0:9644"]
    ports:
      - 8080:8080
    depends_on:
      - redpanda-0

  3. Run the following in the directory where you saved the docker-compose.yml file:

    docker compose up -d

For more information on getting started, see Redpanda Quickstart.

  • Fedora/RedHat/Amazon Linux

  • Debian/Ubuntu

  1. Add the redpanda-unstable repository to your package manager:

    curl -1sLf \
  'https://dl.redpanda.com/E4xN1tVe3Xy60GTx/redpanda-unstable/setup.rpm.sh'

  2. Install Redpanda:

    sudo yum install redpanda

  1. Add the redpanda-unstable repository to your package manager:

    curl -1sLf \
  'https://dl.redpanda.com/E4xN1tVe3Xy60GTx/redpanda-unstable/setup.deb.sh'

  2. Get updated package information for your machine:

    sudo apt-get update

  3. Install Redpanda:

    sudo apt-get install redpanda

Beta versions are not available through Homebrew. The Homebrew formula is only updated for general availability (GA) releases.

For beta testing on macOS, use Docker.

  1. Install Redpanda with Helm from the RC build in Docker Hub:

    helm repo add redpanda https://charts.redpanda.com
helm repo add jetstack https://charts.jetstack.io
helm repo update
helm install cert-manager jetstack/cert-manager --set crds.enabled=true --namespace cert-manager --create-namespace
helm install redpanda redpanda/redpanda \
  --namespace <namespace> \
  --create-namespace --set image.repository=docker.redpanda.com/redpandadata/redpanda-unstable --set image.tag=v25.3.5 --set console.enabled=false

  2. Generate and deploy the manifest for Redpanda Console v3 beta:

    helm template consolev3 oci://registry-1.docker.io/redpandadata/console-unstable \
  --namespace <namespace> \
  --create-namespace \
  --version v0.0-k8s0-968fcab9-helm-chart \
  --set "image.tag=" \
  --set "secretMounts[0].name=redpanda-default-cert" \
  --set "secretMounts[0].secretName=redpanda-default-cert" \
  --set "secretMounts[0].defaultMode=272" \
  --set "secretMounts[0].path=/etc/tls/certs/default" \
  --set "config.kafka.brokers[0]=redpanda-0.redpanda.redpanda.svc.cluster.local.:9093" \
  --set "config.kafka.brokers[1]=redpanda-1.redpanda.redpanda.svc.cluster.local.:9093" \
  --set "config.kafka.brokers[0]=redpanda-2.redpanda.redpanda.svc.cluster.local.:9093" \
  --set "config.kafka.sasl.enabled=false" \
  --set "config.kafka.tls.caFilepath=/etc/tls/certs/default/ca.crt" \
  --set "config.kafka.tls.enabled=true" \
  --set "config.kafka.tls.insecureSkipTlsVerify=false" \
  --set "config.schemaRegistry.enabled=true" \
  --set "config.schemaRegistry.tls.caFilepath=/etc/tls/certs/default/ca.crt" \
  --set "config.schemaRegistry.tls.enabled=true" \
  --set "config.schemaRegistry.tls.insecureSkipTlsVerify=false" \
  --set "config.schemaRegistry.urls[0]=https://redpanda-0.redpanda.redpanda.svc.cluster.local.:8081" \
  --set "config.schemaRegistry.urls[1]=https://redpanda-1.redpanda.redpanda.svc.cluster.local.:8081" \
  --set "config.schemaRegistry.urls[2]=https://redpanda-2.redpanda.redpanda.svc.cluster.local.:8081" \
  --set "config.redpanda.adminApi.enabled=true" \
  --set "config.redpanda.adminApi.tls.caFilepath=/etc/tls/certs/default/ca.crt" \
  --set "config.redpanda.adminApi.tls.enabled=true" \
  --set "config.redpanda.adminApi.tls.insecureSkipTlsVerify=false" \
  --set "config.redpanda.adminApi.urls[0]=https://redpanda.redpanda.svc.cluster.local.:9644" > console-deployment-v3.yaml

kubectl apply -f console-deployment-v3.yaml

  3. Forward the ports to access Redpanda Console locally:

    kubectl --namespace <namespace> port-forward svc/consolev3-console-unstable 8080:8080

  4. Navigate to http://localhost:8080.