<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0"><channel><title><![CDATA[Feedback about the documentation]]></title><description><![CDATA[<p dir="auto">This is what I experienced as a new user. I'm not great at communicating like this so don't take it as rudeness please.</p>
<hr />
<p dir="auto">The <a href="https://homebox.software/en/quick-start/install/#linux" rel="nofollow ugc">Linux instructions</a> say to launch the binary with <code>./homebox</code> but that leads to the following error and the top search results are all for API References.</p>
<p dir="auto"><code>panic: auth.api_key_pepper must be set to at least 32 bytes; generate with `openssl rand -base64 48` and provide via HBOX_AUTH_API_KEY_PEPPER. Rotating it invalidates all issued API keys</code></p>
<p dir="auto">The Configure page has a tab for the CLI Option <code>--auth-api-key-pepper</code> but the <a href="https://homebox.software/en/quick-start/configure/#hbox_web_host-examples" rel="nofollow ugc">instructions below that</a> are only for systemd installs, not for using the binary like the installation page says you can do.</p>
<p dir="auto">I didn't test that because I'm using Aurora OS and really only want to launch it as needed like an app. I created the api key and launched the binary successfully, but it's apparently not persistent and I need to create a sh file.</p>
<p dir="auto">I register and click to create an item. The only entity option is "Location" which I know isn't what I want to use. I go to the page for User Guide/Items. Nothing here explains that you have to create an entity before creating an item. It states that, "Items and locations are both entities in Homebox, differentiated by their <a href="https://homebox.software/en/user-guide/entity-types" rel="nofollow ugc">entity type</a>." But that link goes to a 404 page.</p>
<p dir="auto">My point is that I think the install and usage instructions could use some clarifications. Obviously I eventually figured everything out through common sense and trial and error. Thank you.</p>


<div class="row mt-3"><div class="col-12 mt-3"><img class="img-thumbnail" src="https://lemmy.world/pictrs/image/55e16506-27d3-4405-930c-cd59faa3a6a2.png" alt="Link Preview Image" /></div></div>]]></description><link>https://forum.ieu.app/topic/56e06ec5-3d91-4297-9b0e-e183949723a2/feedback-about-the-documentation</link><generator>RSS for Node</generator><lastBuildDate>Sun, 06 Sep 2026 06:00:37 GMT</lastBuildDate><atom:link href="https://forum.ieu.app/topic/56e06ec5-3d91-4297-9b0e-e183949723a2.rss" rel="self" type="application/rss+xml"/><pubDate>Tue, 25 Aug 2026 02:59:06 GMT</pubDate><ttl>60</ttl></channel></rss>