Installation/Setup (Devel system)

1. Prepare your local system:

   $ sudo zypper in docker docker-compose gcc python3-devel jq make
   

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

   $ python3 -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. Setting up the SSC credentials for docker:

   (if you don’t use Docker click here for more information)

7. Create a file for credentials (line for line):

   $ cat <<EOF > ./docker/secrets/SCCcredentials
    username=SCC_xxx
    password=xxx
    system_token=xxx
    EOF
   

8. Run the test server:

   $ make up-dev
   

   If you wish to test for the production environment instead, use the Makefile target below. It automatically provisions a NetBox API token as the docker/secrets/NetboxToken Docker secret before starting the stack, so no manual steps are needed:

   $ make up-testing
   

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

   127.0.0.1 authentik.orthos2.test orthos2.orthos2.test cobbler.orthos2.test netbox.orthos2.test testmachine.orthos2.test
   

10. Open your browser and go to http://orthos2.orthos2.test.

    Now you have to change the URL from:

    “https://orthos2.orthos2.test/login/?next=/machines/free”

    to:

    “https://orthos2.orthos2.test/login/?builtin=true”

11. LogIn: you can find the login password for the admin user in ./docker/orthos/orthos2dev.env Enjoy.