> ## Documentation Index
> Fetch the complete documentation index at: https://anionex-feat-editable-text-only-export.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Try the demo or deploy Banana Slides locally

## Online Demo

No installation needed — try it instantly: [bananaslides.online](https://bananaslides.online/)

***

## Self-Hosting

### Step 1: Install Docker

<Tabs>
  <Tab title="Windows / macOS">
    Download and install [Docker Desktop](https://www.docker.com/products/docker-desktop/). After installation, launch it and confirm the Docker icon appears in the system tray (Windows) or menu bar (macOS).
  </Tab>

  <Tab title="Linux">
    ```bash theme={null}
    curl -fsSL https://get.docker.com | sh
    ```
  </Tab>
</Tabs>

### Step 2: Download and Start

Create a new directory, enter it, and run the following command to download the config files and start the service:

```bash theme={null}
mkdir banana-slides && cd banana-slides && \
curl -O https://raw.githubusercontent.com/Anionex/banana-slides/main/docker-compose.prod.yml && \
curl -O https://raw.githubusercontent.com/Anionex/banana-slides/main/.env.example && \
cp .env.example .env
```

Edit the `.env` file to fill in your API key (see [Configuration](/configuration)), then start:

```bash theme={null}
docker compose -f docker-compose.prod.yml up -d
```

<Tip>
  [AIHubMix](https://aihubmix.com/?aff=17EC) is recommended for API keys — it supports both Gemini and OpenAI formats and handles high-concurrency image generation reliably.
</Tip>

### Step 3: Open the App

Visit [http://localhost:3011](http://localhost:3011) in your browser.

<Note>
  Default ports are 3011 (frontend) and 5011 (backend). To change them, set `FRONTEND_PORT` and `BACKEND_PORT` in `.env`.
</Note>

***

## Update

In the app, open **Settings → About → Check for Updates** to compare the current version SHA with the latest available version. Local source-code runs are checked with the current Git SHA as well.

```bash theme={null}
docker compose -f docker-compose.prod.yml pull && \
docker compose -f docker-compose.prod.yml up -d
```

## View Logs

```bash theme={null}
docker logs -f --tail 100 banana-slides-backend
```

***

## Deploy from Source

<Accordion title="Expand for source deployment steps">
  ### Requirements

  * Python 3.10+
  * [uv](https://github.com/astral-sh/uv) package manager
  * Node.js 16+ and npm

  ### Backend

  ```bash theme={null}
  git clone https://github.com/Anionex/banana-slides
  cd banana-slides
  cp .env.example .env  # Edit .env and add your API key
  cd backend
  uv run alembic upgrade head && uv run python app.py
  ```

  ### Frontend

  ```bash theme={null}
  cd frontend
  npm install
  npm run dev
  ```
</Accordion>