EntryPoint

A lightweight self-hosted dashboard for accessing your personal services, homelab applications and external tools.

Built with SvelteKit, TailwindCSS and Docker.

Features

• Responsive dashboard UI
• Minimalist dark theme
• Categorized and uncategorized services
• JSON-based configuration
• Optional icons and descriptions
• Optional same-tab navigation
• Docker-ready
• Persistent configuration
• Runtime-served custom icons
• No database required
• No authentication
• Simple and fast setup

Preview

EntryPoint is designed to work as a personal launcher for:

• Self-hosted applications
• Docker services
• NAS tools
• Monitoring stacks
• External developer tools
• Local network resources

Examples:

• Grafana
• Portainer
• Home Assistant
• phpMyAdmin
• MinIO
• Redis Insight
• Gitea
• Jellyfin
• Nextcloud
• IT Tools

Tech Stack

• SvelteKit
• TailwindCSS
• TypeScript
• Docker
• Docker Compose

Getting Started

Clone the repository

git clone https://github.com/Markkano/EntryPoint.git
cd EntryPoint

Run with Docker

docker compose up --build -d

The dashboard will be available at:

http://localhost

Configuration

Services are configured using:

config/services.json

On first startup, EntryPoint automatically creates the file from:

config/services.example.json

Example Configuration

{
    "services": [
        {
            "name": "Grafana",
            "url": "http://grafana.local",
            "icon": "grafana.png",
            "status": {
                "enabled": true
            }
        }
    ],
    "categories": [
        {
            "name": "Databases",
            "services": [
                {
                    "name": "phpMyAdmin",
                    "url": "http://phpmyadmin.local",
                    "status": {
                        "enabled": true
                    }
                }
            ]
        }
    ]
}

Service Properties

Minimal service

{
    "name": "Grafana",
    "url": "http://grafana.local"
}

Full example

{
    "name": "Grafana",
    "url": "http://grafana.local",
    "description": "Monitoring dashboard",
    "icon": "grafana.png",
    "same_tab": true,
    "status": {
        "enabled": true
    }
}

Icons

Icons can be:

• Local runtime icons
• Static bundled icons
• External URLs

Runtime icons

Place uploaded/custom icons in:

data/icons

And reference them as:

{
    "icon": "/icons/grafana.png"
}

Docker Volumes

The following folders are persisted:

volumes:
  - ./data:/app/data

This allows:

• Persistent configuration
• Persistent uploaded icons
• Easy backups
• Easy migration between servers

Development

Run locally:

npm install
npm run dev -- --host

Default development URL:

http://localhost:5173

Planned Features

• Online status checks
• Config hot reload
• Drag & drop reordering
• Add/Edit services from UI
• Categories management
• Upload icons from UI
• TCP ping
• Import / Export configuration

Philosophy

EntryPoint is intentionally simple.

The goal is to provide:

• A clean self-hosted dashboard
• Minimal setup
• Human-readable configuration
• Easy portability
• No unnecessary complexity

About This Project

EntryPoint is primarily a personal learning project.

I'm building it to:

• Learn and improve with SvelteKit
• Experiment with frontend architecture and UI design
• Practice Docker-based deployments
• Build tools that are actually useful in my homelab

The project intentionally keeps things simple and lightweight while evolving incrementally over time.