findIT

findIT is a service discovery tool for finding various IT division services that are hosted and/or made by students of the Chalmers IT Student Division.

How it works

The application queries the local Docker socket for running containers that have specific labels, and it also supports manually managed services through the admin panel. It groups all services by category and displays them in a web interface.

Usage

For Services

To make a service appear in findIT, add the following labels to your Docker container:

Label	Description	Required
findit.enable	Set to true to opt-in.	Yes
findit.title	The name of the service.	Yes
findit.url	The URL to access the service.	Yes
findit.description	A brief description of the service.	Yes
findit.category	The category to group the service under.	Yes
findit.github_url	URL to the source code.	No
findit.icon	Icon name from the shared icon library.	No

Manual Services

If a service cannot be discovered through Docker, you can add it from the admin panel at /admin.

• Manual services support the same fields as Docker labels: title, URL, description, category, optional GitHub URL, and optional icon.
• Icons are selected from the shared icon library managed in the same admin panel.

Admin Authentication

The admin panel uses OpenID Connect and stores application sessions in SQLite.

• Users authenticate through the configured OIDC provider, currently intended for Gamma at https://auth.chalmers.it.
• The /admin page and all admin server mutations are protected.
• Session state is stored in the app database, while the browser only keeps a secure session cookie.

Copy .env.example to .env and fill in the OIDC settings before starting the app.

Required authentication variables:

Variable	Description
OIDC_ISSUER_URL	OIDC issuer URL, e.g. https://auth.chalmers.it
OIDC_CLIENT_ID	Client ID registered with the provider
OIDC_CLIENT_SECRET	Client secret registered with the provider
OIDC_REDIRECT_URL	Redirect URI registered with the provider, e.g. http://localhost:8080/auth/callback
SESSION_COOKIE_SECRET	Long random secret used to encrypt the session cookie

Optional authentication variables:

• SESSION_TTL_HOURS to change how long app sessions remain valid.

Optional Docker cache tuning variables:

• DOCKER_CACHE_TTL_SECONDS controls how long Docker-discovered services stay cached before the next refresh. Default: 5.
• DOCKER_CACHE_RETRY_SECONDS controls how long the server waits after a failed Docker refresh before trying again. Default: 2.

Running findIT

Prerequisites

• Rust and Cargo
• Dioxus CLI (cargo install dioxus-cli)
• Docker (with access to the Docker socket)

Development

To start the development server:

cp .env.example .env
dx serve

Production

To build for production:

dx build --release

The application requires access to /var/run/docker.sock to function.