On GitHub, pawelmalak/flame has picked up 6.7k stars, TypeScript. Flame is self-hosted startpage for your server. Easily manage your apps and bookmarks with built-in editors.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Flame is self-hosted startpage for your server. Its design is inspired (heavily) by SUI. Flame is very easy to setup and use. With built-in editors, it allows you to setup your very own application hub in no time - no file editing necessary.
Functionality
📝 Create, update, delete your applications and bookmarks directly from the app using built-in GUI editors
📌 Pin your favourite items to the homescreen for quick and easy access
🔍 Integrated search bar with local filtering, 11 web search providers and ability to add your own
🔑 Authentication system to protect your settings, apps and bookmarks
🔨 Dozens of options to customize Flame interface to your needs, including support for custom CSS, 15 built-in color themes and custom theme builder
☀️ Weather widget with current temperature, cloud coverage and animated weather status
🐳 Docker integration to automatically pick and add apps based on their labels
Installation
With Docker (recommended)
Docker Hub link
docker pull pawelmalak/flame
# for ARM architecture (e.g. RaspberryPi)
docker pull pawelmalak/flame:multiarch
# installing specific version
docker pull pawelmalak/flame:2.0.0
Deployment
# run container
docker run -p 5005:5005 -v /path/to/data:/app/data -e PASSWORD=change_me pawelmalak/flame
Building images
# build image for amd64 only
docker build -t flame -f .docker/Dockerfile .
# build multiarch image for amd64, armv7 and arm64
# building failed multiple times with 2GB memory usage limit so you might want to increase it
docker buildx build \
--platform linux/arm/v7,linux/arm64,linux/amd64 \
-f .docker/Dockerfile.multiarch \
-t flame:multiarch .
Docker-Compose
version: '3.6'
services:
flame:
image: pawelmalak/flame
container_name: flame
volumes:
- /path/to/host/data:/app/data
- /var/run/docker.sock:/var/run/docker.sock # optional but required for Docker integration
ports:
- 5005:5005
secrets:
- password # optional but required for (1)
environment:
- PASSWORD=change_me
- PASSWORD_FILE=/run/secrets/password # optional but required for (1)
restart: unless-stopped
# optional but required for Docker secrets (1)
secrets:
password:
file: /path/to/secrets/password
Docker Secrets
All environment variables can be overwritten by appending _FILE to the variable value. For example, you can use PASSWORD_FILE to pass through a docker secret instead of PASSWORD. If both PASSWORD and PASSWORD_FILE are set, the docker secret will take precedent.
Follow instructions from wiki: Installation without Docker
Development
Technology
Backend
Node.js + Express
Sequelize ORM + SQLite
Frontend
React
Redux
TypeScript
Deployment
Docker
Kubernetes
Creating dev environment
# clone repository
git clone https://github.com/pawelmalak/flame
cd flame
# run only once
npm run dev-init
# start backend and frontend development servers
npm run dev
Screenshots
Usage
Authentication
Visit project wiki to read more about authentication
Search bar
Searching
The default search setting is to search through all your apps and bookmarks. If you want to search using specific search engine, you need to type your search query with selected prefix. For example, to search for "what is docker" using google search you would type: /g what is docker.
For list of supported search engines, shortcuts and more about searching functionality visit project wiki.
Setting up weather module
Obtain API Key from Weather API.
Free plan allows for 1M calls per month. Flame is making less then 3K API calls per month.
Get lat/long for your location. You can get them from latlong.net.
Enter and save data. Weather widget will now update and should be visible on Home page.
Docker integration
In order to use the Docker integration, each container must have the following labels:
labels:
- flame.type=application # "app" works too
- flame.name=My container
- flame.url=https://example.com
- flame.icon=icon-name # optional, default is "docker"
# - flame.icon=custom to make changes in app. ie: custom icon upload
"Use Docker API" option must be enabled for this to work. You can find it in Settings > Docker
You can also set up different apps in the same label adding ; between each one.
The above command will bind the docker engine server to the Unix socket as well as TCP port of your choice. “0.0.0.0” means docker-engine accepts connections from all IP addresses.
Restart the daemon and Docker service
sudo systemctl daemon-reload
sudo service docker restart
Test if it is working
curl http://${IP}:${PORT}/version
Kubernetes integration
In order to use the Kubernetes integration, each ingress must have the following annotations:
metadata:
annotations:
- flame.pawelmalak/type=application # "app" works too
- flame.pawelmalak/name=My container
- flame.pawelmalak/url=https://example.com
- flame.pawelmalak/icon=icon-name # optional, default is "kubernetes"
"Use Kubernetes Ingress API" option must be enabled for this to work. You can find it in Settings > Docker
Import HTML Bookmarks (Experimental)
Requirements
python3
pip packages: Pillow, beautifulsoup4
Backup your db.sqlite before running script!
Known Issues:
generated icons are sometimes incorrect
pip3 install Pillow, beautifulsoup4
cd flame/.dev
python3 bookmarks_importer.py --bookmarks <path to bookmarks.html> --data <path to flame data folder>
Custom CSS and themes
See project wiki for Custom CSS and Custom theme with CSS.
No homepage URL was recorded for pawelmalak/flame in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
How active is development on pawelmalak/flame?
The most recent commit recorded on pawelmalak/flame was 4 months ago, based on the GitHub push timestamp. The repository has 361 forks — one of the better signals of community interest.
Is pawelmalak/flame open source?
Yes — pawelmalak/flame ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/pawelmalak/flame.
What license does pawelmalak/flame use?
pawelmalak/flame is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
What topics is pawelmalak/flame associated with?
GitHub's repository topics for pawelmalak/flame: "homepage", "self-hosted", "startpage". TopGit's editorial category is open-source.
Where do I read more about pawelmalak/flame?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/pawelmalak/flame is the definitive source.
Read full README in the tab above.
Curious whether flame is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about flame.