Easy-Gate

Easy-Gate is a lightweight, self-hosted startpage and dashboard for your infrastructure. It reads services and notes from a configuration file and displays them in a clean, organized interface.

Features

• Service Directory — list and categorize all your self-hosted services
• Notes Section — add quick reference notes alongside your services
• Real-Time Updates — configuration changes are reflected without restart
• User Groups — control access to services based on IP addresses
• Categories — organize services into logical groups
• Single Binary — no external database or dependencies required

First-Time Setup

Easy-Gate reads its configuration from a JSON or YAML file. You can pass the entire configuration via the EASY_GATE_CONFIG environment variable, or mount a config file at a custom path via EASY_GATE_CONFIG_PATH.

By default, a minimal configuration is included. To customize, update the EASY_GATE_CONFIG environment variable in Zeabur's Service > Variables section with your JSON configuration.

Configuration Example

{
  "title": "My Homelab",
  "services": [
    {
      "name": "Grafana",
      "url": "https://grafana.example.com",
      "category": "Monitoring",
      "icon": "grafana"
    }
  ],
  "notes": [
    {
      "title": "VPN Access",
      "content": "Connect to VPN before accessing internal services"
    }
  ]
}

Persistent Data

Easy-Gate is stateless and reads from its config. No persistent volume is needed.

License

MIT — GitHub