AsoBeast

App Store and Google Play keyword rank tracker and ASO tool.

  • ghcr.io/hsinghhira/asobeast:latest
  • v1.16.0
  • Updated 10 Nov 2026
  • port 6700
  • amd64 · arm64
  • Developer
  • 151 stars

Screenshots

AsoBeast screenshot 1: OverviewAsoBeast screenshot 2: Action Center

Open the app

Web App

http://localhost:6700/

About AsoBeast

AsoBeast is an open source App Store Optimization (ASO) tool and keyword rank tracker for the Apple App Store and Google Play. It tracks your keyword rankings daily, watches competitors, reviews and listing changes, and turns the history into a list of ASO work to do. Your keyword list never leaves your server. PostgreSQL and Redis are inside this one container.

Features

  • Import an App Store or Google Play listing and track keywords in any storefront, ranked to depth 200 every day
  • Popularity and difficulty scores that show their evidence
  • Competitor discovery, keyword gaps, top charts and review mining
  • Action Center: a ranked queue of ASO work with the evidence for each
  • Alerts by webhook or email, an API and an MCP server for AI agents

How to use

  1. Open AsoBeast from your dashboard.
  2. Create the owner account. Sign-up closes after that.
  3. Paste an App Store or Google Play link to import your app.
  4. Add keywords and markets; rankings start right away.

Before you install

Set PUBLIC_URL to the address you open AsoBeast at, like http://192.168.1.20:6700. It works from any address, but links in emails and alerts use this one. Open http://[ZIMAOS-IP-ADDRESS]:6700 and create the owner account; sign-up then closes. Over plain http use Chrome or Firefox: Safari only keeps you signed in over https.

The first start takes about two minutes. Every secret is made for you and kept in the data folder. More settings (email, AI, schedules, retention) are in the Variables tab; add them in the app settings.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone. It is filled in from your ZimaOS time zone. Leave it unless you need another.
PUBLIC_URLhttp://localhost:6700The address you open AsoBeast at, like http://192.168.1.20:6700 or https://aso.example.com. AsoBeast works from any address; this one is used for links in emails and alerts. With https, the sign-in cookie is marked secure.

Sign-up and accounts

VariableDefault valueDescription
AUTH_ALLOW_REGISTRATIONfalseSet to true to keep sign-up open after the owner account exists.
AUTH_REGISTRATION_WORKSPACEownWhere a new sign-up lands: own (their own workspace) or shared (your workspace, as members).
AUTH_SESSION_DAYS7How many days a sign-in lasts.

Email (SMTP)

VariableDefault valueDescription
SMTP_HOST—Your mail server, like smtp.gmail.com, for email alerts, password resets and invitations.
SMTP_PORT587Your mail server's port (465 with SMTP_SECURE=true).
SMTP_SECUREfalseSet to true for TLS from the start (port 465).
SMTP_USER—The user name for your mail server.
SMTP_PASSWORD—The password for your mail server.
SMTP_FROM—The address email comes from.

AI

VariableDefault valueDescription
OPENAI_API_KEY—An OpenAI (or compatible) API key for optional AI summaries and review replies. Leave it out and AsoBeast works without AI.
OPENAI_BASE_URL—An OpenAI-compatible server, like your own Ollama at http://192.168.1.20:11434/v1.
AI_MODELgpt-5.6-lunaThe model name as your provider spells it (needs vision and structured output).
AI_CALLS_PER_MONTH—A monthly cap on AI calls. Left out, there is none.

Store collection

VariableDefault valueDescription
SCRAPE_ITUNES_RPM15App Store requests per minute.
SCRAPE_GPLAY_RPM10Google Play jobs per minute. Halve it if you see BlockedError.
SCREENSHOT_OCRtrueSet to false to stop reading the text on store screenshots.

Schedules

VariableDefault valueDescription
CRON_DAILY0 3 * * *When the daily ranking run starts, as a cron pattern in UTC.

Alerts

VariableDefault valueDescription
ALERT_DELIVERYbatchedbatched sends up to two reports a day after the daily run; instant sends each event at once.
ALERT_RANK_DROP_THRESHOLD5How many places a keyword must move before it alerts.
WEBHOOK_ALLOW_PRIVATE_TARGETSfalseSet to true to send webhook alerts to addresses on your home network.

Data retention

VariableDefault valueDescription
RETENTION_RANKINGS_DAYS365Delete keyword rankings older than this many days; 0 keeps them forever.
RETENTION_SERP_DAYS90Delete search result snapshots older than this many days; 0 keeps them forever.

Store consoles

VariableDefault valueDescription
GOOGLE_PLAY_OAUTH_CLIENT_ID—A Google OAuth web client ID, so owners connect Google Play by signing in with Google. Its redirect is your PUBLIC_URL followed by /integrations/google-play.
GOOGLE_PLAY_OAUTH_CLIENT_SECRET—The secret of that Google OAuth client.

Reverse proxy

VariableDefault valueDescription
ASOBEAST_TRUST_PROXY2How many proxies sit in front of the API, counting the two inside this container. Set 3 behind your own reverse proxy, so rate limits see each visitor's address.

Logs

VariableDefault valueDescription
LOG_LEVELlogHow much the API logs: error, warn, log, debug or verbose.
docker-compose.yml
name: asobeast

services:
  asobeast:
    image: ghcr.io/hsinghhira/asobeast:latest
    container_name: asobeast
    restart: unless-stopped
    stop_grace_period: 90s
    privileged: true
    environment:
      - TZ=$TZ
      - PUBLIC_URL=http://localhost:6700
    ports:
      - target: 8080
        published: "6700"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/data
        target: /data
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "curl", "-fsS", "-o", "/dev/null", "http://127.0.0.1:8080/api/health"]
      interval: 30s
      timeout: 10s
      retries: 5
      start_period: 180s
    deploy:
      resources:
        limits:
          cpus: "2.00"
          memory: 2048M
        reservations:
          cpus: "0.25"
          memory: 384M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/asobeast/icon.png
    x-casaos:
      id: com.icestore.asobeast
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone. It is filled in from your ZimaOS time zone.
              Leave it unless you need another.
        - container: PUBLIC_URL
          description:
            en_US: >-
              The address you open AsoBeast at, like http://192.168.1.20:6700
              or https://aso.example.com. AsoBeast works from any address;
              this one is used for links in emails and alerts. With https,
              the sign-in cookie is marked secure.
      ports:
        - container: "8080"
          description:
            en_US: AsoBeast web app and API, published on host as 6700
      volumes:
        - container: /data
          description:
            en_US: >-
              The database (postgres/), the job queues (redis/) and the
              secret keys (state/). Back up the whole folder: without
              state/secrets.env, connected store credentials can't be read.

x-casaos:
  id: com.icestore.asobeast
  architectures:
    - amd64
    - arm64
  main: asobeast
  author: HSinghHira
  category: Developer
  developer: AsoBeast
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/asobeast/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/asobeast/screenshot-1.jpg
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/asobeast/screenshot-1.jpg
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/asobeast/screenshot-2.jpg
  title:
    en_US: AsoBeast
  tagline:
    en_US: App Store and Google Play keyword rank tracker and ASO tool.
  description:
    en_US: >-
      Visit: [https://icestore.hsinghhira.me/app/asobeast/](https://icestore.hsinghhira.me/app/asobeast/) for full details


      AsoBeast is an open source App Store Optimization (ASO) tool and keyword
      rank tracker for the Apple App Store and Google Play. It tracks your
      keyword rankings daily, watches competitors, reviews and listing
      changes, and turns the history into a list of ASO work to do. Your
      keyword list never leaves your server. PostgreSQL and Redis are inside
      this one container.


      **Features**


      - Import an App Store or Google Play listing and track keywords in any
        storefront, ranked to depth 200 every day

      - Popularity and difficulty scores that show their evidence

      - Competitor discovery, keyword gaps, top charts and review mining

      - Action Center: a ranked queue of ASO work with the evidence for each

      - Alerts by webhook or email, an API and an MCP server for AI agents


      **How to use?**


      1. Open AsoBeast from the Zima OS dashboard.


      2. Create the owner account. Sign-up closes after that.


      3. Paste an App Store or Google Play link to import your app.


      4. Add keywords and markets; rankings start right away.
  tips:
    before_install:
      en_US: >-
        1. Open the app configuration before you install.


        2. Find PUBLIC_URL. It starts as http://localhost:6700. Change
           localhost to your ZimaOS IP, like http://192.168.1.20:6700, so
           links in emails work. AsoBeast opens from any address either way.


        3. More settings, like email alerts, OpenAI help and data retention,
           are listed on the AsoBeast page at
           https://icestore.hsinghhira.me/app/asobeast/ (Variables tab). You
           can add them now or later in the app settings.


        4. Start the installation.


        5. Wait about two minutes. The first start sets up the database.


        6. Open http://[ZIMAOS-IP-ADDRESS]:6700 and create the owner
           account. The app's logs show the address in the box marked
           CREDENTIALS.


        7. Use Chrome or Firefox over plain http. Safari only keeps you
           signed in over https.
  index: /
  port_map: "6700"
  scheme: http
  is_uncontrolled: false
  version: "1.16.0"
  update_at: "2026-11-10"
  release_notes:
    en_US: |-
      - First IceStore release: upstream's published stack in one container, on port 6700 with one data folder.
      - AUTH_SECRET, the store-credential encryption key and the database password are made on first start.
      - With an http PUBLIC_URL the sign-in cookie is sent without the secure flag, so it works on your home network.
      - asobeast-api 1.16.0
      - asobeast-web 1.16.0
      - PostgreSQL 18 and Redis inside
      - Fixed: the API stopped at the database migration add_application_role ("permission denied to create role"). The database user now has the same rights as in upstream's setup; an install that already hit this repairs itself on the next start.
  repo: "https://github.com/AsoBeast/asobeast"
  support: "https://github.com/AsoBeast/asobeast/issues"
  docs: "https://docs.asobeast.com"

Install AsoBeast

Something not working with AsoBeast?

Report it so it gets fixed, or ask for an app that is not here yet.

More Developer apps

See all