ordinary-dev / phoenix

Self-hosted start page without the extra stuff

Phoenix

Self-hosted start page without the extra stuff.

Features

• No javascript
• Authorization support
  • SSO via Trusted Header Auth (Reverse Proxy)
• Font Awesome integration
• Multiple styles
• Export and import

Configuration

Service settings can be set through environment variables.

Variable	Description	Default
P_DBPATH	Path to the sqlite database.	Docker: /var/lib/phoenix/db.sqlite3
P_SECRETKEY	A long and random secret string used for authorization.
P_LOGLEVEL	Log level settings: debug, info, warning, error, fatal	warning
P_HEADERAUTH	Enable Trusted Header Auth (SSO)	false
P_DEFAULTUSERNAME	Data for the first user.
P_DEFAULTPASSWORD	Data for the first user.
P_SECURECOOKIE	Controls the "secure" option for a token cookie.	true

Appearance settings:

Variable	Description	Default
P_TITLE	Website title	Phoenix
P_FONTFAMILY	The font used on the site. Inserted directly into css.	sans-serif

Docker-compose example

services:
  phoenix:
    image: ghcr.io/ordinary-dev/phoenix
    volumes:
      - phoenix:/var/lib/phoenix
    ports:
      - 80:8080
    environment:
      P_SECRETKEY: "your-random-string"
      P_DEFAULTUSERNAME: "admin"
      P_DEFAULTPASSWORD: "super-password"
    restart: unless-stopped

volumes:
  phoenix:

Icons

You can use the free version of Font Awesome.

The name of the icon must be specified in the following form: set name/icon name, for example: brands/github or regular/credit-card.

phoenix's Issues

Increase spacing between groups on mobile devices

Implement authorization check as middleware

Keep settings page position after editing

Feedback

Been looking for a "Start Page" or "App Directory" of sorts for all the self-hosted apps and services I run and manage (which of which I've written myself). Came across your project and tried it out locally. It "just works" 👌 Nice! 🥳

For me to use this seriously in production (open to contributions) I would want to see a few things:

• Support for Single-Sign-On (SSO), ideally via Trusted Header Auth with something like Authelia in front, See: https://www.authelia.com/integration/trusted-header-sso/introduction/
  • Or support for OAuth2 or OpenID Connect
• Support for"App Icons". Perhaps even "tiles" as a UX option?
• Some way of adding "default links / apps" so authorized users can add their own (if they wish) but always get a set of pre-defined defaults created by the admin.

Thanks!

Add support for prefixes in the url

500 error, no logs

Hey! 👋

I'm not very familiar with Gin, and don't normally use any web frameworks myself in my projects. Since some ~8hr ago, my phoenix instance started reporting 500 errors for every request. I'm not able to bring it back online in any way. I checked the database with sqlite and it appears to be fine. Near as I can tell there are also no logs either. Is this failing deep within Gin somewhere? How? Why all of a sudden? How does one even debug this?!

Implement csrf protection?

Add area-labels for buttons without text

Add favicon

Run public demo