# iSulad

**Repository Path**: netdebug/iSulad

## Basic Information

- **Project Name**: iSulad
- **Description**: iSulad is a light weight container runtime daemon which is desinged for IOT and Cloud infrastructure.
- **Primary Language**: C
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 305
- **Created**: 2020-01-03
- **Last Updated**: 2024-04-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<img src="logo/isula-logo.png" alt="iSulad" style="zoom:80%;" />

## iSulad

`iSulad` is a light weight container runtime daemon which is desinged for IOT and Cloud infrastructure.`iSulad` has the characteristics of light, fast and not limited by hardware specifications and architecture, and can be applied more widely.

## Getting Started

### Installing
To install iSulad, you can use `rpm` or `yum` package manager command with `openEuler` repository.

Install iSulad with yum
```sh
yum install -y iSulad
```

### Run
We provide `systemd` service to start `iSulad`
```sh
systemd start lcrd # run the server with systemd command
```

You can use direct command to start `iSulad` server：
```sh
$ sudo lcrd  # run the server with default socket name and default log level and images manage function
```
### Operations on containers:
`iSulad` provides command line `lcrd` to talk with server.
Here are some sample commands to manager containers.

List all containers in your own environment:
```sh
# list containers
$ sudo lcrc ps -a   
```

Create a container with busybox named `test`
```sh
# create a container 'test' with image busybox       
$ sudo lcrc create -t -n test busybox  
```

Start this container `test`
```sh
# start the container 'test'          
$ sudo lcrc start test                
```
Kill the container `test`
```sh
# kill the container 'test'   
$ sudo lcrc kill test  
```
Remove the container `test`
```sh
# remove the container 'test'     
$ sudo lcrc rm test                        
```

### Build from source
Build requirements for developers are listed in [build_guide](./doc/build_guide.md)

## How to Contribute

We always welcome new contributors. And we are happy to provide guidance for the new contributors.
iSulad follows the kernel coding conventions. You can find a detailed introduction at:

- https://www.kernel.org/doc/html/v4.10/process/coding-style.html

## Licensing

iSulad is licensed under the Mulan PSL v1.