# Install Organizr - A Homelab Services Organizer/Dashboard - on Linux

## 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/

## Installation

1. Log into the Linux device
2. Run the following commands in a terminal window:
   # update software repositories
   sudo apt update
   # install available software updates
   sudo apt upgrade -y
   # install prerequisites
   sudo apt install curl wget zip git openssl -y
   # install Apache HTTPD and SQLite
   sudo apt install apache2 sqlite3 -y
   # install PHP components
   sudo apt install php7.4 libapache2-mod-php php7.4-common php7.4-mysql php7.4-sqlite3 php7.4-xml php7.4-zip php7.4-curl php7.4-fpm -y
   # download the latest organizr release
   wget -O ./organizr.zip https://github.com/causefx/Organizr/archive/v2-master.zip
   # extract the downloaded zip to /var/www/html
   sudo unzip ./organizr.zip -d /var/www/html
   # rename the extracted folder organizr
   sudo mv /var/www/html/Organizr* /var/www/html/organizr
   # set the owner of the organizr directory
   sudo chown -R www-data:www-data /var/www/html/organizr
   # create organizr apache configuration
   sudo nano /etc/apache2/sites-available/organizr.conf
3. Paste the following configuration into organizr.conf

   <Directory /var/www/html/organizr>
   Options Indexes FollowSymLinks
   AllowOverride All
   Require all granted
   RewriteEngine On
   RewriteCond %{REQUEST_FILENAME} !-f
   RewriteCond %{REQUEST_FILENAME} !-d
   RewriteRule ^ /organizr/api/v2/index.php [QSA,L]
   </Directory>

4. Press CTRL+O, Enter, CTRL+X to write the changes
5. Run the following command to enable the Organizr site
   # enable rewrite module
   sudo a2enmod rewrite
   # enable the organizr site
   sudo a2ensite organizr
   # restart the apache2 service
   sudo systemctl restart apache2
   # generate a random string
   head /dev/urandom | LC_ALL=C tr -dc 'A-Za-z0-9' | head -c 30

## Organizr Web Installer

1. Open a web browser and navigate to http://DNSorIP/organizr
2. Set the Installation Type to Personal > Click Next
3. Complete the registration form by entering a username, email address and password > Click Next
4. Copy the randomly generated string from the open terminal and paste it in the Hash Key field
5. Enter a Registration Password > Click Next
6. Enter organizr.db as the Database Name and /var/www/html/organizr/data/ as the Database Path > Click Test / Create Path > Click Next
7. Review the summary > Click Finish
8. Welcome to Organizr

Source: https://docs.organizr.app/installation/prerequisites/installing-php