Admin Features not Available #2

Open
opened 2026-01-08 16:39:25 +00:00 by fabby · 3 comments
Owner

The current documentation for the generic Butter Box image includes access to admin features to change the default password, add a password to the WiFi, change the encryption settings, etc., using RaspAP.
The Kanglam image does not have that feature currently and it would be very useful for that specific context.

The current documentation for the generic Butter Box image includes access to admin features to change the default password, add a password to the WiFi, change the encryption settings, etc., using RaspAP. The Kanglam image does not have that feature currently and it would be very useful for that specific context.
Owner
Previous features: https://docs.likebutter.app/quick-start/add-wifi-password
Owner

From before:

Changing the Wi-Fi password for your Butter Box hotspot from the admin dashboard is straightforward. Here are the steps:

Access the RaspAP Web Interface
Open a web browser on a device connected to your Butter Box and type http://butterbox.lan/admin

From before: Changing the Wi-Fi password for your Butter Box hotspot from the admin dashboard is straightforward. Here are the steps: Access the RaspAP Web Interface Open a web browser on a device connected to your Butter Box and type http://butterbox.lan/admin
Owner

Looks like the older versions of raspap were using basic authentication, but newer versions have a login page at /login (see https://docs.raspap.com/features-core/authentication/). This is the page you get redirected to when accessing the panel for the first time.

However, raspap does not support a configurable base path, so this redirect is missing the /admin prefix. The web server we use, lighttpd, also does not support intercepting raspap responses and rewriting them to have the correct prefix.

The fix long-term is to move to nginx and remove lighttpd, or at least add nginx in front of lighttpd to intercept these responses.

Or we could tweak the documentation slightly, as the admin features are still available, but the login flow is changed:

To access the admin features, first go to http://butterbox.lan/admin/login and login with the default credentials. This will redirect you to the main page (http://butterbox.lan); after this step, going to http://butterbox.lan/admin will allow you to configure raspap as required.

Looks like the older versions of raspap were using basic authentication, but newer versions have a login page at /login (see https://docs.raspap.com/features-core/authentication/). This is the page you get redirected to when accessing the panel for the first time. However, raspap does not support a configurable base path, so this redirect is missing the /admin prefix. The web server we use, lighttpd, also does not support intercepting raspap responses and rewriting them to have the correct prefix. The fix long-term is to move to nginx and remove lighttpd, or at least add nginx in front of lighttpd to intercept these responses. Or we could tweak the documentation slightly, as the admin features are still available, but the login flow is changed: To access the admin features, first go to http://butterbox.lan/admin/login and login with the default credentials. This will redirect you to the main page (http://butterbox.lan); after this step, going to http://butterbox.lan/admin will allow you to configure raspap as required.
irl added this to the Butter Box project 2026-01-20 16:46:21 +00:00
Sign in to join this conversation.
No labels
No milestone
No project
No assignees
3 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: butter/butter-kanglam-ui#2
No description provided.