Maybe_Web

Maybe_Web

Docker app from dkeners' Repository

Overview

Maybe is an all-in-one personal finance platform. Track, optimize, grow, and manage your money through every stage of life. This is image 1 of 2 needed to run Maybe finance, **please see additional requirements.** " Maybe" is a trademark of Maybe Finance, Inc.

dkener's unraid-templates

My Unraid Community Addon template repository, setup support is found in this README.

  • Maybe Finance

    • Maybe_Web

    • Maybe_Worker

Apps

Maybe Finance

Maybe does not officially support this release method, it is just something I have put together; AS SUCH, if there are issues with the app that are likely due to weird installation config, please raise an issue here or on the Unraid Forum thread for these apps. We don't need to flood the Maybe issues page with our love of Unraid. However, if you see something that you think is a bug of the software please report it on the Maybe issues page!

Install:

Docker Sub-Net Setup

💡    Tip: I recommend running the app in its own docker sub-net, this limits what the app can happily (or accidentally) talk to. See #2912

  1. Open the Unraid console, the >_ in the top right corner.
  2. Run the command: docker network create maybe-stack Replace maybe-stack with whatever name you want, just be sure to use that for the rest of the guide.

Redis & PostgreSQL Setup

✏    Note: *This app requires you to install both Redis and Postgres in addition to the web and worker apps. Having these misconfigured is maybe the biggest cause of self-hosting problems based off of GitHub issues.

  1. Install a PostgreSQL app from Community Addons store, any will likely work, I use sgraaf's template.
  2. Input the following settings (names may vary):
    • Name: maybe_db
    • Repository: postgres:16
    • Network Type: Custom : maybe-stack
    • Data Storage Path: /mnt/user/appdata/maybe/postgres-data
    • DB User: maybe_user
    • DB Password: 1234 <- Try to do better
    • DB Name: maybe_production
  3. PostgreSQL will build your database the first time you run the app, changing any database settings after the first build will not change anything. Your database should not be running!
  4. Install a Redis app from the Community Addons store, again, any will work. I use jj9987's template.
  5. Input the following settings (names may vary):
    • Name: maybe_redis
    • Repository: redis:latest
    • Network Type: Custom : maybe-stack
    • Data Storage Path: /mnt/user/appdata/maybe/redis-data

Maybe_Web Setup

  1. Find Maybe_Web in the community addon store.
  2. Input the following settings (names may vary):
    • Name: maybe_web (can be whatever you want to see as the app name)

      Maybe is very actively developed, for now it is recommended to stay on latest to get all the new features and fixes. If you want you can pin it to a cetain release by changing latest to 0.5.0.

    • Repository: ghcr.io/maybe-finance/maybe:latest

    • Network Type: Custom : maybe-stack

    • Secret Key: {Your key here!}

      • To generate the key go to the Unraid console; >_ in the top right corner.
      • Run openssl rand -hex 64.
      • Copy the output and paste in the Seceret Key input.

      Docker allows us to specify a host by the name of the container, which we defined earlier. If your postgres what not configured using this guide provide the IP (X.X.X.X) or URL (joe.com) of your database.

    • Postgres - Host: maybe-db

    • Postgres - Username: maybe-user

    • Postgres - Password: {Whatever you used earlier}

    • Postgres - Database: maybe-production

    • Redis - URL: redis://maybe_redis:6379/1

    • Config data: /mnt/user/appdata/maybe/app-storage

      To get the following optional setting click Show more settings...

    • OpenAI API Token: {Your OpenAI Token, be happy I dont know it ;)}

  3. Click done, the app should start running, but it won't work yet! you have to configure the Maybe_Worker.

Maybe_Worker Setup

  1. We don't want to have to enter all that again, find the Add Container button in the bottom left of the Docker page.
  2. In the Add Container form, click the Select a template dropdown.
  3. In the dropdown, under User templates select maybe_web.
  4. Voilà! It's pre-filled! Change the following settings (names may vary):
    • Name: maybe_worker

      Turn on ADVANCED VIEW, toggle in top right, will say BASIC VIEW when off

    • Post Arguments: bundle exec sidekiq

    • Click REMOVE on the Web UI Port: input.

      Turn off ADVANCE VIEW

  5. Click done, the app should build and Maybe should be fully functional!

Install Maybe_Web on Unraid in a few clicks.

Find Maybe_Web in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Maybe_Web Review the template variables and paths Click Install

Requirements

This is image 1 of 2 needed to run Maybe finance, run alongside //Maybe_Worker\\. Requires Maybe v0.5.0 or later.
Requires a //Postgres\\ database (version 16), and //Redis\\.
See the Maybe documentation for more information: https://github.com/maybe-finance/maybe/blob/main/docs/hosting/docker.md

Related apps

Details

Repository
ghcr.io/maybe-finance/maybe:latest
Last Updated2026-07-13
First Seen2024-09-02

Runtime arguments

Web UI
http://[IP]:[PORT:3000]
Network
bridge
Shell
sh
Privileged
false
Extra Params
--restart unless-stopped

Template configuration

Web UI PortPorttcp
Target
3000
Default
3000
Value
3000
Secret KeyVariable

Secret key. Run `openssl rand -hex 64` to generate a secret

Target
SECRET_KEY_BASE
Postgres - HostVariable

Postgres database host. Suggested: {YOUR-POSTGRES-DOCKER-NAME}

Target
DB_HOST
Postgres - PortVariable

Postgres database port

Target
DB_PORT
Default
5432
Value
5432
Postgres - UsernameVariable

Postgres database username. Default: maybe_user

Target
POSTGRES_USER
Default
maybe_user
Postgres - PasswordVariable

Postgres database password

Target
POSTGRES_PASSWORD
Postgres - DatabaseVariable

Postgres database name. Default: maybe_production

Target
POSTGRES_DB
Default
maybe_production
Redis - URLVariable

The Redis host URL. Suggested: redis://{YOUR-REDIS-DOCKER-NAME}:6379/1

Target
REDIS_URL
Default
127.0.0.1:6379/1
Config dataPathrw

Config data for application. Should be the same dir as Maybe Worker.

Target
/rails/storage
Default
/mnt/user/appdata/maybe/app-storage
Value
/mnt/user/appdata/maybe/app-storage
Is Self-HostedVariable

Is the application self-hosted. Not recommended to change.

Target
SELF_HOSTING_ENABLED
Default
true|false
Value
true
Enforce SSLVariable

Enforce SSL connections. Not recommended to change.

Target
RAILS_FORCE_SSL
Default
false|true
Value
false
Assume SSLVariable{3}

Assume SSL connections. Not recommended to change.

Target
RAILS_ASSUME_SSL
Default
false|true
Value
false
Good Job Execution ModeVariable{3}

Good Job execution mode. Not recommended to change.

Target
GOOD_JOB_EXECUTION_MODE
Default
async
Value
async
OpenAI API TokenVariable

Note: Enabling OpenAI will incur costs when you use AI-related features in the app (chat, rules). Please set spending limits.

Target
OPENAI_ACCESS_TOKEN