Introducing HAVEN Kit, a tool to get a Nostr relay up and running with just a few clicks. HAVEN Kit uses the incredible HAVEN relay along (thank you @utxo the webmaster ๐Ÿง‘โ€๐Ÿ’ป and @Anthony Accioly) with a custom configuration UI to help you get a relay running very quickly. You can set up with a simple configuration which just requires an npub and a user name, or do a full configuration to edit every variable in your HAVEN relay. The project creates two containers, one for the relay and one for the config UI (written in Python because I'm not a Go guy) so anyone can set this up anywhere. There is also an Umbrel configuration so you can set this up easily on an Umbrel node if you wish. I would appreciate some user testing and feedback before I submit to the Umbrel app store. I did all my testing with Podman because I prefer it to Docker so testing and feedback from Docker users is also welcome. image Project repo down below and thank you to @Dikaios1517 for posting the note that inspired me to work on this project.

Replies (52)

Running into some trouble with the manual install. The directory ~/umbrel/apps couldn't be found, so it just dumped the repo directory into my ~/umbrel directory. Is it meant to go into the ~/umbrel/umbrel/app-data directory instead? I went ahead and put it there, but still doesn't want to install. Can't find any such file or directory named "haven" even after I cd into the app-data directory.
Wow! Before I even have to head out the door! I installed from the community app store you created. Decided to go with the simple config to get started. Plugged in an npub and username so it can name my relays, saved the configuration and got a success message, then hit the "Restart Now" button and got this error: image Did it maybe install the GUI container but didn't install the relay?
Ok, no longer getting the error. When accessing my Umbrel through my local network and I hit the "Restart Now" button, it tells me that Haven has successfully restarted, but the indicator in the top right still says "HAVEN Stopped." Interestingly, when I access my Umbrel through Tor and do the same thing, the indicator says "HAVEN Running" for a few seconds, and then tells me it stopped. Logs show "havenkit-haven_haven_relay_1 | 2025/10/22 05:07:48 Environment variable OWNER_NPUB not set" even though I have set an npub and saved it in the Simple Configuration option. That said, if I switch to the Full Configuration option, the npub I had previously set does not show, but it DOES show back up if I switch back to the Simple Configuration, even though the logs seem to show that an npub still has not been set. Also, is there anywhere in the UI that the user will be able to get the Tor address for the relay? I am assuming it would have a separate onion address from the main Umbrel dashboard one, like other services running on Umbrel do.
I did catch the issue when switching between configs a bit ago so i'll get that taken care of. i know you say it shows "HAVEN Stopped" but is the relay running even though it says stopped? As for the Tor address, not yet, but i will look into it!
I am guessing no. The only things I am seeing for "haven_relay_1" in the loggs is "Environment variable OWNER_NPUB not set." The bulk of the rest of the logs are for "haven_config_ui_1" and they are all ""GET /api/status HTTP/1.1" 200 -"
I tried this in Umbrel. Haven service is not starting. Also, it's not persisting configuration changes. I added npub and other details but when I reopened everything was gone.
Okay haven is up now but there are problems. Check screenshots below. 1. Import failed and there is a typo marked in red. image 2. Wrong relay url. image 3. Add and display some relays by default here, and maybe give bulk add option. image 4. Add "Save Configuration" button on every step of the configuration, not only at the last step. 5. I first did quick configuration, then manual configuration. But I think it's taking preference from quick config. Because I changed relay name in manual config but it's showing old relay name.
I think that incorrect relay URL may also be affecting the Blossom server. After updating, I set up a reverse proxy to do some testing and so far I am able to write to my outbox relay, and it is blasting the note to the relays I have in the blaster config section, so the next thing I went to test was uploading to the Blossom server. However, Amethyst wouldn't even let me add the Blossom server. Thinking it might be an Amethyst issue, I added it in Bouquet and that seemed to work, but Amethyst was still unable to successfully upload to the server. It seemed to get stuck when trying to re-download the image. That being the case, I decided to upload via Bouquet and copy/paste the URL into Amethyst, and this is what I got: image I manually corrected the URL: image When I posted the note, the image loaded. Strangely, though, it rotated the image when I uploaded it. This was a portrait orientation on my phone: image
Yep. My request was prior to the creation of his own community app store. Since you're here, though. I was wanting to play with Blob Box, but it doesn't seem to want to let me add any npubs to the whitelist. I keep getting this error when I try: image
Ok I found one issue. I couldn't find blossom file in umbrel directory so I checked the container and the blossom file was present at /haven instead of /haven/blossom and 'blossom' word appended to it. I think you missed a '/' image
Folder permission issue, by default folders in docker are owned by the root user to I need to include a script to change the permissions so the app can access it
Not sure what the issue is, but I am unable to install Haven Kit now. I uninstalled it to see if doing a fresh install and only typing in "haven.brightbolt.net" would resolve my multiple URL prefix issue, but it won't let me reinstall now. Hopped over to my other Umbrel and tried installing there to confirm whether it was because of previously having Haven Kit installed and I couldn't install it there, either, even though it had never been installed on that device before. Install gets to "Installing 1%" and then goes back to the standard "Install" button. Seems to create the haven-kit directory in my app-data folder, along with at least some of the required files, but no icon shows up on my Umbrel dashboard to launch the app.
Not sure but I'm doing a bugfix release in a couple days so I'll see if there's any issues on my end.
โ†‘