README.md

<img src=img/hamara-new.png height=80 width=80>  `Hamara GNU/Linux` https://www.hamaralinux.org
======


`Hamara` is more than an operating system which focuses specifically for the needs of the Indian users and
so in turn help increase linux adoption in India.


> Initial release of distro named `Hamara Namaste` was based on Ubuntu 14.04.


> Lightweight version of Hamara named `Hamara Sugam` which is in its development phase is based on Debian Testing(buster).




Before getting started with development , lets see the structure of Hamara development system:


Whole Hamara development activity and its source code is hosted on `http://git.hamaralinux.org` (runs out our own gitlab instance) .


So , before getting started Feel free to Register at `http://git.hamaralinux.org` and post to the developer mailing
list `hamara-devel@lists.hamaralinux.org`
to request access to the specific repo.


### Hamara developers project contains following repos  :-
-----
- [**Hamara Packages**](https://git.hamaralinux.org/hamara-developers/hamara-packages) - contains source code for hamara packages.



- [**Hamara Helpers**](https://git.hamaralinux.org/hamara-developers/hamara-helpers) - contains hamara helper scripts need to customize
package names according to distro.

- [**Hamara Live Build**](https://git.hamaralinux.org/hamara-developers/hamara-live-build) - contains scripts for building hamara ISO

- [**Hamara Installer**](https://git.hamaralinux.org/hamara-developers/installer) - contains source for hamara installer


If you are **working on packages**, you may need access to:

https://git.hamaralinux.org/hamara-developers/hamara-packages


> After switching upstream from Ubuntu to Debian , the building of hamara is done by fetching upstream Debian from one of the mirror
> (https://www.debian.org/mirror/list) and mirroring on [devel.hamaralinux.org](devel.hamaralinux.org) which  acts as the developer package
>repositories which we keep up to date everyday.


> [devel.hamaralinux.org](devel.hamaralinux.org) Hosts the development repositories for Hamara Sugam and Hamara Svastik.
> [build.hamaralinux.org](build.hamaralinux.org) acts as build server where we do all our builds for packages and ISO's using Jenkins.



> Another host [archive.hamaralinux.org](archive.hamaralinux.org) consists live package repositories which are final results of several
>modifications done on packages from devel.hamaralinux.org

Hamara build structure is shown in the image below :

![](img/structure.png)

## || `Development of Hamara` ||
----


Before getting started you need any GNU/linux (preferably `Debian` ) distribution on your machine then next steps will
help you to quickly get started with Hamara GNU/Linux development.


## [Getting started with Hamara Sugam Development](docs/sugam-development.md)


## `**Docs**`


### [HowTo's](docs/howto.md)

### [Release Process](docs/release_process.md)



# `**Get Involved**`

Becoming part of hamara community allows you to shape the direction of the operating system.
Put yourself in control of your system and come join us on our mission to free our machines.


## Hamara Forum
----

Join the [forum](http://forum.hamaralinux.org/) to get advice and discuss Hamara with the rest of the community



## Bugs
----

Found a problem with Hamara linux or have a suggestion? Speak to our [bugzilla](http://bugs.hamaralinux.org/)



## FAQ
----


Answers to common questions can be found on the [faq](http://www.hamaralinux.org/faq).

Thanks to T. Shrinivasan at the FSFTN for asking most of these.

## Hamara Wiki
----

For more information related to Hamara installation and troubleshooting, you can visit Hamara [Wiki](http://wiki.hamaralinux.org/).

## Mailing Lists
----

Subscribe to our mailing lists below:


**Announcements**

[hamara announce](http://lists.hamaralinux.org/listinfo/hamara-announce)


**Hamara Developers List**

[hamara dev](http://lists.hamaralinux.org/listinfo/hamara-devel)


**Hamara Users List**

[hamara users](http://lists.hamaralinux.org/listinfo/hamara-users) - help, support and discussion


## Connect using IRC Channel/Matrix/Telegram
---
You can join in on IRC with a dedicated IRC client or web browser, pidgin is one of the IRC client which are included in
Hamara Distributions.

### IRC
Join using following details:

**`Channel - #hamara`**


**`Server - irc.oftc.net`**

### Matrix
If you use [Matrix](Matrix.org), you can join the matrix group here

**`https://chat.diasp.in/#/room/#hamara:diasp.in`**

### Telegram
You can also join the telegram group here
**`https://t.me/hamaraLinux`**

Be it IRC/Matrix/Telegram, they are all bridged together. So everyone from any medium gets all messages.    

## Hamara Source Code
----

Hamara source code is available here https://git.hamaralinux.org/hamara-developers/hamara-packages . You are welcome to clone it and
start contributing to hamara community. You can join hamara IRC chanel or mailing list for any questions you might have about using the
source.

## Hamara Repo
----
Hamara live repo is hosted at http://archive.hamaralinux.org/hamara/ and the devel repo can be found at
http://devel.hamaralinux.org/hamara/