# How to setup

AdminUI is a PHP application that requires a different setup to work locally.

Some of the below steps you probably made when you was installing the other applications
If you already made, you can skip the step.

  1. Make sure you have access to JumiaPayAIG (opens new window) repositories.

  2. If you haven't installed docker yet, follow step 1 of this guide (opens new window)

  3. If you didn't have github tokens, follow this step (opens new window)

  4. Use git to get the latest Jumia docker repository (opens new window) update.

  5. Make sure to have "AWS Single Sign-On" assigned to your OKTA Account. Remember that AWS Credentials expiry daily, so you may need to update your exports, see step 3 of this guide (opens new window).

  6. Open a terminal window and navigate to the "docker" folder that you cloned

  7. run the command below to see a list of current running containers:

docker ps 

Check if the containers are Up and running.
If the containers are ok, jump to next step, if not, run below command:

./bin/docker.sh

And choose: Up Containers

  1. run
./bin/database.sh

Select "Kong Gateway Database"

If you get error such as "No such container: PGPASSWORD=mario", make sure the containers are running and you made the correct setup.

  1. On the same terminal, run:
make migrate-konga
  1. To guarantee PHP packages that are needed to AdminUI to work, run
./bin/frontend.sh

choose "composerAdmin"
You may need to run this with sudo

  1. run
./bin/docker.sh

and choose "Restart Containers"

  1. Access https://admin.jumiapay.dev/ (opens new window), the AdminUI is ready locally