Install 25.1 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.1.1-rc3, 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

  • Kubernetes

  1. Pull the latest RC build from Docker Hub:

    docker pull docker.redpanda.com/redpandadata/redpanda-unstable:v25.1.1-rc3
  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.1.1-rc3
        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:v2.8.5
        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
  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.1.1-rc3 --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=v3.0.0-beta.1" \
      --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.