Running Organizr - A Homelab Services Organizer/Dashboard - in Docker 🌱

What is Organizr?

ORGANIZR aims to be your one stop shop for your Servers Frontend. Do you have quite a bit of services running on your computer or server? Do you have a lot of bookmarks or have to memorize a bunch of ip’s and ports? Well, Organizr is here to help with that... -https://organizr.app/

Installing Docker

  1. Log into the Linux based device
  2. Run the following commands in the terminal
    # install prerequisites
    sudo apt install apt-transport-https ca-certificates curl software-properties-common gnupg-agent -y
    # add docker gpg key
    curl -fsSL https://download.docker.com/linux/$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release)/gpg | sudo apt-key add -
    # add docker software repository
    sudo add-apt-repository "deb [arch=$(dpkg --print-architecture)] https://download.docker.com/linux/$(awk -F'=' '/^ID=/{ print $NF }' /etc/os-release) $(lsb_release -cs) stable"
    # install docker
    sudo apt install docker-ce docker-compose containerd.io -y
    # enable and start docker service
    sudo systemctl enable docker && sudo systemctl start docker
    # add the current user to the docker group
    sudo usermod -aG docker $USER
    # reauthenticate for the new group membership to take effect
    su - $USER

Running the Organizr Container

  1. Now that Docker is installed, run the following commands to setup the Organizr Docker container and run it
    # create working directory
    mkdir ~/docker/organizr -p
    # set ownership on the working directories
    sudo chown "$USER":"$USER" ~/docker -R
    # list current uid and gid, note these for later
    id $user
    # run the organizr container
    docker run -d --name=organizr -p 8880:80 -v ~/docker/organizr:/config -e PGID=1000 -e PUID=1000 --restart unless-stopped organizr/organizr
  2. Open a web browser and navigate to http://DNSorIP:8880
  3. Select Personal from the Install Type dropdown > Click Next
  4. Enter an Admin Username, Email and Password > Click Next
  5. Open a new browser tab and navigate to https://www.random.org/passwords/?num=1&len=24&format=plain&rnd=new
  6. Copy the generated random string > Paste the string in the Hash Key field
  7. Go back to the random.org tab and refresh the page to generate a new string
  8. Copy the generated random string > Paste the string in the Registration Password
  9. Click Next
  10. On the Database settings page enter the Database Name organizr and set the Database Location to /config/www/organizr/data/ > Click the Test/Create Path button > Click Next
  11. Review the Summary > Click Finish
  12. Welcome to Organizr

Documentation: https://hub.docker.com/r/organizr/organizr
Source: https://docs.organizr.app/installation/installing-organizr