# 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