Installation/Setup (Devel system)

1. Prepare your local system:

   $ sudo zypper in docker docker-compose openldap2-devel cyrus-sasl-devel
   

2. Check out the sources:

   $ git clone git@github.com:openSUSE/orthos2.git
   $ cd orthos2/
   

3. Create the virtual Python environment, activate it and update pip

   $ python -m venv .venv
   $ . .venv/bin/activate
   $ pip install --upgrade pip
   Collecting pip
   ...
   

4. Install the required Python modules for development:

   $ pip install -r requirements-devel.txt -r docs/requirements.docs.txt
   Collecting django
   ...
   

5. Generate the required secrets to bring up the Docker Compose Stack:

   python3 docker/manage-secrets.py
   

6. Run the test server:

   docker compose up -d
   

7. Edit your /etc/hosts file and include the following line:

   127.0.0.1 orthos2.orthos2.test cobbler.orthos2.test netbox.orthos2.test
   

8. Open your browser and go to http://orthos2.orthos2.test (use the superuser login here). The login password for the admin user you can find in docker/orthos/orthos2.env.