GitStream - An interactive Git tutorial system

Installation

Ubuntu

Warning: Deprecated.

sudo add-apt-repository ppa:gitstream/gitstream
sudo apt-get update && sudo apt-get install gitstream

General

Download and access GitStream repository:

git clone https://github.com/uid/gitstream.git
cd gitstream

Install development dependencies:

• Node.js v22
• apt packages: git nginx nodejs make
• MongoDB Community Edition

Build and install GitStream:

make install

Make sure certs are in their appropriate locations (see nginx-deployed.conf for the locations):

sudo service nginx reload
sudo -u gitstream pm2 start dist/server/main.js

Development

Install Dependencies

1. Download GitStream Excercises repository and place inside the root folder of GitStream.
2. Install Docker.
3. Ensure special configuration files are in the main directory: gistream.pem, settings.js

Test

• Run test cases via npm test.
• To locally test multiple users, comment out openid config in settings.js.

Run

1. Start the Docker containers using docker compose up --build.

2. You can now view GitStream by navigating your browser to one of the exercises, e.g.: http://localhost:8000?theGitGo.