Skip to content
FunCoding

rebuild-launcher

Rebuild and restart the Saiku launcher fat-JAR after changing saiku-ui or Java code, without shipping stale UI bundles or breaking the running JVM. Use when asked to run, rebuild, or restart Saiku locally, or when a UI change "doesn't show up" in the launcher.

Star
1,329
License
Apache-2.0
Last commit
Oct 13, 2026

.agents/skills/rebuild-launcher/SKILL.md

View on GitHub

Rebuild the launcher

Two traps make a naive mvn package go wrong here; this sequence avoids both.

  1. Stop any running launcher first. Its JVM holds the fat-JAR open. mvn clean deletes it, and Mondrian's Janino ServiceLoader then fails with NoSuchFileException, so every MDX discover/query returns HTTP 500 until you restart.
    pkill -f 'saiku-launcher/target/saiku-.*\.jar' || true
    
  2. Clean the webapp and launcher modules. The war overlay never purges old hashed SvelteKit bundles (_app/immutable/...<hash>.js), so an incremental package ships old and new side by side.
    mvn -pl saiku-webapp,saiku-launcher clean
    
  3. Build the fat-JAR. This also runs npm ci + npm run build for saiku-ui through the frontend plugin.
    mvn -pl saiku-launcher -am -Dmaven.test.skip=true package
    
  4. Run it.
    VERSION=$(mvn -q -DforceStdout help:evaluate -Dexpression=project.version)
    SAIKU_ALLOW_DEFAULT_ADMIN=true java -jar saiku-launcher/target/saiku-$VERSION.jar serve --port 8080 --home ./saiku-home
    
    UI at http://localhost:8080/ui/, REST at http://localhost:8080/rest/saiku/api/, login admin / admin. Without SAIKU_ALLOW_DEFAULT_ADMIN=true (or SAIKU_DEMO=true, or a real SAIKU_ADMIN_PASSWORD) the launcher refuses to boot on the default password.

If you changed the FoodMart seed schema (saiku-launcher/src/main/resources/seed/FoodMart4.xml), an existing saiku-home won't pick it up. Delete saiku-home/data/FoodMart4.xml before relaunching.

Similar Skills

blender-motion-state-inspection

AFaffaan-m/ECC278k4,046 new stars in the last 7 days

Official

slack-gif-creator

ANanthropics/skills181k1,119 new stars in the last 7 days

Featured

algorithmic-art

Generate flow fields and particle systems with p5.js, using seeded randomness for original algorithmic art.

ANanthropics/skills181k1,119 new stars in the last 7 days

thinking-out-loud

SHShubhamsaboo/awesome-llm-apps141k808 new stars in the last 7 days

moneyprinterturbo-video

HAharry0703/MoneyPrinterTurbo130k1,722 new stars in the last 7 days

complain

PApaperclipai/paperclip101k2,948 new stars in the last 7 days