Get 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, it's 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 don't 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.

If you want to work on localhost, execute:

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

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 server's 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 don't have it, download here

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

If you work on localhost, you should type 127.0.0.1/aamks in google chrome.

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

Log in.

Now you can work on your project!