Download AAMKS on your system

1. Install Docker

Below instruction how to install docker on Ubuntu 20.04. If some issues appear, check here.

How to install docker on different platforms, check here.

Open terminal and execute commands:

(always copy the text after $)

$ sudo apt-get update

$ sudo apt-get install \ apt-transport-https \ ca-certificates \ curl \ gnupg \ lsb-release

$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

$ sudo apt-get install docker-ce docker-ce-cli containerd.io

Check that docker works:

$ docker

(Check is only to test process, its not necessery to execute)

2. Download image

Download aamks image from dockerhub

$ docker pull zarooba/aamksinstall:working

Check that you have proper image downloaded:

$ docker image ls

3. Create network

Create network on which aamks will serve data, if you dont want to work on localhost

$ docker network create --subnet=192.168.0.0/16 net_aamks

Check that the network exists:

docker network ls

4. Run container

Run container based on aamks image

$ docker run -it --network=net_aamks zarooba/aamksinstall:working

Running container is shown in last line: root@------------:/usr/local#. The rest of commands should be executed in container.

5. Restart apache and postgres

Apache2 and Postgresql have to be restarted to work properly

Restart these services in working container (root@------------:/usr/local#)

$ service apache2 restart

$ service postgresql restart

During restarting apache2 you will see message:

AH00558: apache2: Could not reliably determine the servers fully qualified domain name, using 170.0.0.2. Set the ServerName directive globally to suppress this message

IP that appears in message (in this case 170.0.0.2) is the IP that has to be written in your browser (google chrome). By this IP your browser will connect with AAMKS.

6. Work on your project!

Open google chrome on your computer. If you dont have it, download here

Run 170.0.0.2/aamks (in this case - IP from step 5.) in google chrome. You should see this:

AAMKS home site should be shown. Click register (under the login form) and fill register form.

Now you can work on your project!