🔎 Introduction
Blinko is an open-source search interface designed to connect to your own vector database, LLM embedding backend, or AI-powered API. It offers a fast, customizable, and clean UI experience for semantic or keyword-based search use cases.
With ClawCloud Run, you can deploy Blinko in one click—completely free. No Docker setup, no server provisioning—just a smooth UI deployed and ready to go with HTTPS and custom domains.
🧾 Prerequisites
- ✅ A ClawCloud account
- ✅ GitHub account that’s at least 180 days old (to unlock $5/month free credits)
- ✅ (Optional) Your own domain name for HTTPS binding
- ✅ A running backend like Weaviate, Qdrant, LlamaIndex, etc., for search results (Blinko is frontend-only)
🚀 Step-by-Step Deployment
Step 1: Log in to ClawCloud Console
- Go to ClawCloud Run Console
- Log in with GitHub
Step 2: Deploy Blinko via the App Store
- In the dashboard, open the “APP Store”
- Search for “Blinko”
- Click “Deploy APP”
This will spin up a Docker container running Blinko’s frontend, ready for connection to your backend.
Step 3: Configure Backend URL
- After deployment, go to APP Launchpad > blinko-xxxxx > Environment
- Set the
BACKEND_URLenvironment variable to your vector DB or search API endpoint (e.g.,https://api.my-search-engine.com) - Click Update to apply changes
Step 4: Access the UI
- Go to APP Launchpad > blinko-xxxxx > Network
- Click the Public Address URL
(e.g.https://blinko-abc123.ap-northeast-1.clawcloudrun.com) - Blinko’s frontend is now live. Connect and test your semantic or keyword-based queries.
⚙️ Customization & Scaling
1. Change Blinko Version
- Under Update > Image, you can change the Docker tag bash复制编辑
ghcr.io/blinko-ai/blinko:latest
2. Add Custom Domain + HTTPS
- Set a CNAME in your DNS to point to the ClawCloud domain
- Under Network > Custom Domain, input your domain
- HTTPS will be provisioned automatically
3. Scale CPU/Memory
- Go to Usage and drag sliders to adjust resource allocations
Ideal for high-concurrency UIs or larger frontend tasks
✅ Why Use ClawCloud for Blinko?
| Feature | Benefit |
|---|---|
| ⚡ One-click Deploy | No server config, just deploy & run |
| 🌐 HTTPS & Domains | Free custom domain with SSL |
| 💸 Forever-Free Tier | $5/mo free credit supports Blinko 24/7 for most users |
| 🔧 Easy Configuration | Change backend API, version, or resources any time |
| 🪄 Fully Containerized | Runs independently—just connect your embedding backend |
📘 Project Links
- GitHub: https://github.com/blinko-ai/blinko
- Docker:
ghcr.io/blinko-ai/blinko