slpkg/docs/how_to_start/index.md

# HOW TO START

## Edit repositories
If you are going to use only the [SlackBuilds.org](https://slackbuilds.org) repository, you don't need to edit
the `/etc/slpkg/repositories.toml` file, otherwise edit the file and set `true` the repositories you want.

# Update database
The second step is to update the package lists and install the data to the database, just run:

```bash
$ slpkg update
```

Now you are ready to start!

## Install packages

To install a package, run:

```bash
$ slpkg install <package_name>
```

or change the repository:

```bash
$ slpkg install <package_name> --repository=<repo_name>
```

You can install a whole repository with the command:

```bash
$ slpkg install '*' --repository=<repository_name>
```

## Remove packages

To remove a package with the dependencies:

```bash
$ slpkg remove <package_name>
```

## Search for packages

If you want to search a package from all repositories, run:

```bash
$ slpkg search <package_name> --repository='*'
```

## Edit configuration

Edit the configuration `/etc/slpkg/slpkg.toml` file:

```bash
$ slpkg configs
```

For further information, please read the manpage:

## Manpage

```bash
$ man slpkg
```