gsadmin/headplane
1
0
Fork 0
mirror of https://github.com/tale/headplane.git synced 2026-08-11 22:36:53 +00:00
Code Issues Packages Projects Releases Wiki Activity

feat: add a warning banner on the login page for misconfigured cookies

Browse Source
This commit is contained in:
Aarnav Tale
2025-11-02 13:54:45 -05:00
parent 7d7e08ee54
commit ce4be73faf
9 changed files with 131 additions and 76 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/configuration/common-issues.md
+25
View File
@@ -0,0 +1,25 @@
---
title: Common Issues
description: Common issues and their solutions
---
# Common Issues and Their Solutions
This document outlines some common issues users may encounter while using Headplane, along with their solutions.
## Login does not work
::: tip
Headplane tries to detect misconfigurations and will surface a warning banner on
the login page if it detects any abnormalities. You may see a banner like this:
<figure>
<img class="dark-only" src="../assets/login-banner-dark.png" />
<img class="light-only" src="../assets/login-banner-light.png" />
<figcaption>Login Warning Banner</figcaption>
</figure>
:::
If you attempt to log in to Headplane but nothing happens, it may be due to a
misconfiguration of the server cookie settings. In your Headplane configuration,
ensure that `server.cookie_secure` is set appropriately based on how you are
accessing Headplane:
- Serving over HTTPS: `cookie_secure` should be enabled (`true`).
- Serving over HTTP: `cookie_secure` should be disabled (`false`).