> For the complete documentation index, see [llms.txt](https://sserra.gitbook.io/livebox/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sserra.gitbook.io/livebox/master.md).

# Welcome

## Initializing Livebox

Using Livebox is a fairly straight forward process, in you `Application` class call:

```java
// Pass context and wanted serializer. 
// This creates a Livebox instance with default values. 
Livebox.init(this, LiveboxGsonSerializer.create());
```

{% hint style="info" %}
Built-in support for Gson and Jackson.
{% endhint %}

You can pass a Config instance to fully customize Livebox behaviour.

```java
Livebox.init(new Config()
                .lruCacheConfig(new DiskLruDataSource.Config(
                        new File("somePath") // Cache file path
                         10 * 1024 * 1024// Cache size in bytes
                ))
                .addSerializer(LiveboxGsonSerializer.create())
                ...
        );
```

Please check Configuration page for more details.

{% content-ref url="/pages/-LLzmg7fhxufRomWeXhl" %}
[Configuration](/livebox/configuration.md)
{% endcontent-ref %}