# Installers

Installers are a set of rules used by Bottles to install a program in a bottle, in a completely silent and automated way.

{% hint style="info" %}
Installers was introduced with Bottles 2022.2.14, read [here](https://usebottles.com/blog/release-2022.2.14/) the release post.
{% endhint %}

These installers take care of configuring the bottle, installing the necessary dependencies, installing the software and making it available to the user with settings that ensure that everything works in the best way.

The novelty introduced by our own installers is the use of the integrated dependency system. This in fact does not use external scripts to install and configure dependencies but uses the same dependency manager accessible from Bottles, so each one of these is automatically managed by Bottles, in the same way you would do it manually from the dependencies page.

Each installer configures the executable in your system (at the moment it does not happen if you are using Flatpak), allowing you to access it at any time from the applications menu of your Desktop Environment. These are done through the Bottles CLI, making sure they use your bottle’s configuration and environment.

### Use installers

Below is a video showing how to use the Installers in Bottles.

{% embed url="<https://www.youtube.com/watch?v=0BQjFlEdSVA>" %}

To use the installers you obviously need a bottle, so select the one you are interested in or create a new one. In the sidebar access the Installers section.

![Bottle - Installers](/files/L6xAmtA6peEJzp3X0FlW)

Choose the installer you want and press the download icon. It will automatically configure your bottle and install the program. When the installation finish, you will see a new entry in your bottle's programs list.

Each installer came with its maintainer review, you can access it from the context menu or from its dedicated page on the [apps catalog](https://usebottles.com/appstore/).

{% hint style="info" %}
Currently it is not possible to launch an installer from our website, we are working to provide this feature.
{% endhint %}

All installers are placed in a [public repository](https://github.com/bottlesdevs/programs) where any user can contribute. If you are interested in make your own installers, please read the [maintainers documentation](https://maintainers.usebottles.com).

### Compatibility grades

Each installer is marked with a compatibility grade based on the results of the testing. If the software is at least usable it is marked as Bronze and better it works higher is going to be considered with a maximum value of Platinum.

The grades are (from worse to best): Bronze, Silver, Gold, Platinum

### Note for architecture

**Important note** installers can declare their architecture so if the bottle created is `Win64` it won't see `Win32` installers and vice versa.

### Refresh installation

Installers can be installed multiple times, also in the same bottle. If you break anything or just want to use the latest installer (as these can receive updates from maintainers), just install it again. Currently Bottles doesn't notify installers updates but will be able to do so in the near future.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.usebottles.com/bottles/installers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.