selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Astroluma logo

Self-host Astroluma

v1.0.2

Self-hosted home lab dashboard with productivity tools

ReleaseOpen SourceGPL-3.0
Docker ComposeCompose file & guide
docker-compose up -d
Updatedlast year
LanguageJavaScript
Setup difficultyModerate
MobileResponsive
Stars
772
Port
8000 (HTTP web interface)
Requires
MongoDB
Docker
sanjeet990/astroluma

What is Astroluma?

Astroluma is a self-hosted home lab dashboard for homelab enthusiasts who want a central interface to manage links, tasks, code snippets, and monitor network devices. It supports multiple users with individual instances, organizes links in nested categories, highlights important links on a featured page, and scans the local network with Wake-on-LAN support. Built-in productivity tools include a todo list manager, snippet storage, and TOTP code generation. The dashboard connects to over 15 external services such as media managers, RSS readers, Git hosting, cloud storage, container orchestration, and monitoring tools. Users can choose from 15 built-in themes, configure icon packs, and adjust the sidebar layout. It runs via Docker Compose alongside a MongoDB database and uses host networking so the network scanner can reach local devices.

Should you self-host Astroluma?

Astroluma scores 49/100 on selfhost.directory (how scoring works) and ranks #18 of 44 in Dashboard. It has 772 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-3.0-licensed and written mostly in JavaScript.

Its closest alternative on selfhost.directory is Homepage by gethomepage (84/100, 33 419 stars). It scores higher overall, so compare the two before you pick. See Astroluma vs Homepage by gethomepage side by side.

Features

  • Custom Domain Support
  • Custom integration support
  • Custom page creation
  • Featured page
  • Flexible layout
  • Icon pack support
  • IP camera stream support
  • Link organization
  • Multi-user support
  • Network device scanning
  • Snippet manager
  • Themes
  • Third-party service integrations
  • Todo list manager
  • TOTP Generation

Astroluma README

How to install Astroluma

Install Astroluma with Docker Compose

Docker and Docker Compose
Environment variables
PORT, NODE_ENV, SECRET_KEY, MONGODB_URI
  1. Create a docker-compose.yml file. Best way to do this is to use the Astroluma Compose

Open Astroluma Compose and chose your preffered settings to generate your docker-compose.yml file.

Alternatively, create a docker-compose.yml similar to this:

version: '3.8'

services:
  app:
    image: sanjeet990/astroluma:latest
    container_name: astroluma
    ##ports:
    ##  - "8000:8000"
    environment:
      PORT: 8000
      NODE_ENV: production
      SECRET_KEY: a2c5f9a8b2d7e1a7f2c9c8d9b5f7a3d5
      MONGODB_URI: mongodb://localhost:27017/astroluma
    volumes:
      - uploads_data:/app/storage/uploads
      - uploads_apps:/app/storage/apps
    depends_on:
      - mongodb
    restart: always
    network_mode: host

  mongodb:
    image: mongo:6.0
    container_name: astroluma_mongodb
    ports:
      - "27017:27017"
    volumes:
      - mongo_data:/data/db
    restart: always


volumes:
  mongo_data:
    driver: local
  uploads_data:
    driver: local
  1. Bring up your stack by running:
docker-compose up -d

If using docker-compose-plugin:

docker compose up -d

Requires host network mode for network scanning functionality

How to configure Astroluma

  • MONGODB_URImongodb://localhost:27017/astrolumaMongoDB connection URI

    MongoDB connection URI

  • NODE_ENVproductionNode.js environment mode

    Node.js environment mode

  • PORT8000Port the application listens on

    Port the application listens on

  • SECRET_KEYSecret key for session encryption

    Secret key for session encryption

Astroluma releases & version history

More in Productivity

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…