Pishahang Installation¶
Pishahang consists of a set of Docker containers (micro services) that cooperate with each other. Hence, installing Pishahang means setting up its Docker containers.
Minimum Requirements¶
Memory: 4GB
Disk: 25GB free space
Procedure¶
Install Docker and Docker Compose¶
On a clean Ubuntu (>=16.04) VM for development, just run
sudo apt install -y curl git
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo curl -L "https://github.com/docker/compose/releases/download/1.25.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo curl -L https://raw.githubusercontent.com/docker/compose/1.25.3/contrib/completion/bash/docker-compose -o /etc/bash_completion.d/docker-compose
On any other machine or in production, follow the official installation instructions for Docker and Docker Compose.
Clone repository and set up environment¶
git clone https://github.com/CN-UPB/Pishahang.git && cd Pishahang
After that, copy the .env.template
file to .env
(e.g., cp .env.template .env
)
The .env
file will be used by Docker Compose and contains initial user data and passwords, as well as the Pishahang version.
Start Pishahang¶
Finally, you can set up and start Pishahang:
sudo docker-compose pull
sudo docker-compose up -d
Verify installation¶
Open your browser and navigate to http://<public_ip>
.
Log in using the username pishahang
and password 1234
.