diff --git a/README.md b/README.md
index 965b9fa..7bd0b17 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,42 @@
-# The openSUSE Tumbleweed MariaDB Client container image
+# MariaDB Client container image
+
 ![Redistributable](https://img.shields.io/badge/Redistributable-Yes-green)
 
-MariaDB Client container based on the openSUSE Tumbleweed Base Container Image.
+## Description
+
+MariaDB is an open-source, multi-threaded, relational database management system. It's a backward-compatible branch of the MySQL Community Server that provides a drop-in replacement for MySQL.
+
+This image contains the [MariaDB client](https://mariadb.com/kb/en/mariadb-command-line-client/) and utilities.
+
+## Usage
+
+To connect to a MariaDB instance, run the following command:
+
+```ShellSession
+$ podman run -it --rm registry.opensuse.org/opensuse/mariadb-client:11.4 mariadb -h $HOST_IP -u root -p
+```
+
+Use the command below to dump all databases:
+
+```ShellSession
+$ podman run -it --rm registry.opensuse.org/opensuse/mariadb-client:11.4 mariadb-dump $HOST_IP -p --all-databases > my-dump.sql
+```
+
+## Utilities
+
+The following utilities are available in the image:
+
+- mariadb
+- mariadb-admin
+- mariadb-check
+- mariadb-dump
+- mariadb-import
+- mariadb-show
+- mariadbd-safe-helper
+
+## Backup and restore
+
+The MariaDB Knowledge Base [Container Backup and Restoration](https://mariadb.com/kb/en/container-backup-and-restoration/) provides further information on how to perform backup and restore.
 
 ## Licensing
 
diff --git a/mariadb-client-image.changes b/mariadb-client-image.changes
index a964b35..251ae31 100644
--- a/mariadb-client-image.changes
+++ b/mariadb-client-image.changes
@@ -1,3 +1,8 @@
+-------------------------------------------------------------------
+Tue Jul  2 14:53:25 UTC 2024 - Alexandre Vicenzi <alexandre.vicenzi@suse.com>
+
+- extend README
+
 -------------------------------------------------------------------
 Mon Jun 24 07:10:18 UTC 2024 - Dirk Mueller <dmueller@suse.com>