diff --git a/docs/.overrides/main.html b/docs/.overrides/main.html
new file mode 100644
index 00000000000000..15896055002242
--- /dev/null
+++ b/docs/.overrides/main.html
@@ -0,0 +1,20 @@
+{% extends "base.html" %}
+
+{% block extrahead %}
+<link rel="apple-touch-icon" sizes="180x180" href="/static/apple-touch-icon.png"/>
+<link rel="icon" type="image/png" sizes="32x32" href="/static/favicon-32x32.png"/>
+<link rel="icon" type="image/png" sizes="16x16" href="/static/favicon-16x16.png"/>
+<link rel="manifest" href="/static/site.webmanifest"/>
+<link rel="mask-icon" href="/static/safari-pinned-tab.svg" color="#2e183d"/>
+<meta name="msapplication-TileColor" content="#d7ff64"/>
+<meta name="theme-color" content="#ffffff"/>
+<meta name="robots" content="index,follow"/>
+<script type="application/ld+json">
+    {
+        "@context": "https://schema.org",
+        "@type": "WebSite",
+        "name": "Astral",
+        "url": "https://astral.sh"
+    }
+</script>
+{% endblock %}
diff --git a/docs/assets/favicon.ico b/docs/assets/favicon.ico
new file mode 100644
index 00000000000000..2da75b736984e7
Binary files /dev/null and b/docs/assets/favicon.ico differ
diff --git a/mkdocs.template.yml b/mkdocs.template.yml
index 34c01de9320ea6..359971d51e4d30 100644
--- a/mkdocs.template.yml
+++ b/mkdocs.template.yml
@@ -2,7 +2,7 @@ site_name: Ruff
 theme:
   name: material
   logo: assets/bolt.svg
-  favicon: assets/ruff-favicon.png
+  favicon: assets/favicon.ico
   features:
     - navigation.instant
     - navigation.instant.prefetch