Getting started

This guide will help you to set up your development environment so you can start development as soon as possible.

This guide is written for Arch Linux however should work fine on mac with some adjustments. Windows users have to install mentioned packages by manually searching for them online.

The code base is being run inside a docker container that contains all the packages. This is recommended because you will not trash your computer with a ton of programs.

First installation

pacman -Syu yay # update the system repositories and install AUR helper
yay -Syu github-desktop-bin git docker docker-compose postman-bin visual-studio-code-bin composer unzip # install packages
sudo usermod -aG docker $USER # A shell restart might be needed after this command.

git clone --recursive [email protected]:pavelskipenes/org.ntnu.svommer.git
cd org.ntnu.svommer
systemctl enable docker --now
composer require stripe/stripe-php
docker-compose up

Note: The password for the database will be printed in the terminal. Take a note of it. To stop serving the site type Ctrl+C in the terminal.

Import data

• Log into https://mysqladmin.it.ntnu.no/ using your credentials -> export -> go.
• Go to your web browser at 127.0.0.1:42069 and login using username root and password that was printed in the terminal window above.
• Click on import and then import the downloaded file from previous step.
• Click on User accounts, add user
• Create user svommer_web with all permissions

Now you're all set. You should see web site on https://127.0.0.1. First time you enter the web site the browser will say that the sertificate is not verified. Ignore that because the docker image is signing the image during creation. You'll also get access to phpmyadmin on 127.0.0.1:42069 (HTTP only).