https://github.com/opatut/minigit

A tiny git server management with user permissions, multiple repos and a web frontend - written in Python using flask. This project was discontinued and replaced by @opatut/mini.
https://github.com/opatut/minigit

Last synced: 15 days ago
JSON representation

A tiny git server management with user permissions, multiple repos and a web frontend - written in Python using flask. This project was discontinued and replaced by @opatut/mini.

• Host: GitHub
• URL: https://github.com/opatut/minigit
• Owner: opatut
• Created: 2012-09-21T13:13:53.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2013-05-12T10:33:36.000Z (over 11 years ago)
• Last Synced: 2023-03-12T02:03:39.809Z (over 1 year ago)
• Language: JavaScript
• Homepage: https://github.com/opatut/mini
• Size: 1.22 MB
• Stars: 0
• Watchers: 1
• Forks: 1
• Open Issues: 7
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Minigit - Git permissions and Web frontend

## What it does

The application has two main uses:

1) Display repository information / files in a web browser.

2) Control permissions from the web frontend and apply them to git pull / push calls.

## How it works

The webapp displays data parsed from the git object files in the bare server repository.The users from the commits are associated with database users based on their eMail address.

For read/write permission control, the webapp writes a `command=gitserve.py $KEY_ID` option into the authorized\_keys file. The `gitserve.py` script can read out the user associated with the public key and redirect the git-receive-pack/git-upload-pack commands or reject them, based on the user's permissions for the requested repository found in the database.

**DO NOT EDIT THE AUTHORIZED_KEYS FILE MANUALLY**. The webapp will overwrite any changes anyway. The `gituser` will not be used for login, only for use with the webapp.

Git remote URLs will have this pattern:

    git://${gituser}@${yourserver}:${sshport}/${repo-slug}.git

## How to use it

This application requires:

* python-virtualenv

* git

When you run the webapp for the first time, run the setup script `setup.sh` to create the virtual environment and install all other requirements into it. The virtual environment is necessary to not clutter your system with the python packages and keep their versions independent from your system versions.

You will also create a configuration file `config.py` from the example file provided. To initialize the database, activate the virtual environment (see below) and run the `kill-database.py` script.

Then, to run the test server, activate the virtual environment and run the server script:

    source env/bin/activate

    ./run.py

You need to have write permission to the repository directory and the authorized\_keys file.