diff --git a/docs/index.md b/docs/index.md
index 41356ad03..1ce4903f4 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,17 +1,5 @@
# Flux documentation
-!!!info "Flux v1 is in maintenance mode"
- You are looking at the documentation of Flux v1, which
- [is in maintenance mode](https://github.com/fluxcd/flux/issues/3320).
-
- The Flux community is working with most of its energy on
- **[Flux v2](https://toolkit.fluxcd.io/)** these days which is a more modern
- approach to GitOps, implements some long-requested features of v1 and
- is generally more flexible. It will be GA soon.
-
- We strongly recommend you familiarise yourself with Flux v2 and start
- looking at your [migration path](https://github.com/fluxcd/flux2/discussions/413).
-
Flux is a tool that automatically ensures that the state of a cluster matches
diff --git a/docs_theme_override/main.html b/docs_theme_override/main.html
new file mode 100644
index 000000000..fe8450030
--- /dev/null
+++ b/docs_theme_override/main.html
@@ -0,0 +1,22 @@
+{% extends "base.html" %}
+
+{% block announce %}
+
+
+ You are looking at the documentation of Flux v1, which is
+ in maintenance mode.
+
+
+
+ The Flux community is working with most of its energy on
+ Flux v2 these days which is a more modern
+ approach to GitOps, implements some long-requested features of v1 and is generally
+ more flexible. It will be GA soon.
+
+
+
+ We strongly recommend you familiarise yourself with Flux v2 and start looking at
+ your migration path.
+
+
+{% endblock %}
diff --git a/mkdocs.yml b/mkdocs.yml
index 852e5f358..05a72e3f8 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -15,6 +15,7 @@ theme:
palette:
primary: blue
accent: indigo
+ custom_dir: docs_theme_override
docs_dir: docs