Installing and configuring a Codio project to use Ungit

Ian avatar
Written by Ian
Updated over a week ago

Ungit brings user friendliness to git without sacrificing the versatility of git.

Project Stack requirements:

The Stack requires node.js (≥ 6.11), npm (≥ 3.10.10, comes with node.js).


To install Ungit open a terminal and run:

sudo -H npm install -g ungit


Configuration file

Create  a configuration file called .ungitrc in your home directory 

  • In the open terminal run:

cd ..

This will take you to the home directory

  • create the file in the directory

touch .ungitrc
  • open the file (vim is also supported in Codio if you prefer to use that)

sudo nano .ungitrc
  • enter the following (please note this must formatted currently as json format)

    "bugtracking": false,
    "logRESTRequests": false,
    "port": 4000
  • save the file and it is recommended you then reopen to confirm correctly formatted

.codio file

Configure your .codio file entering these lines (you can append to any existing settings you may have in this file)

// Configure your Run and Preview buttons here.

// Run button configuration
  "commands": {
        "Start Ungit":"ungit --port=4000 --ungitBindIp"


// Preview button configuration
  "preview": {
                 "Visit Ungit": "https://{{domain4000}}/#/repository?path=%2Fhome%2Fcodio%2Fworkspace"




The Start Ungit run command shouldn't be generally be needed to be run as you start the project Ungit will automatically start and you can click the Visit Ungit button in the preview menu to open Ungit but in the event it could stop, you can use this to start the Ungit server.
You can also change the preview option to access Ungit either inside your Codio project (using Inside Codio) or in a new browser tab (using New Browser Tab)

Click here for more information on Ungit, 

Did this answer your question?