# Lens

Lens is a collaborative CAD platform for uploading, viewing, and sharing 3D models with version control, export capabilities, and real-time collaboration tools. It is open source and self-hosted, installable on TrueNAS.

Canonical page: https://ourlocalhost.com/app/3718/lens

## Description

Lens is a collaborative CAD platform for uploading, viewing, and sharing 3D models with version control, export capabilities, and real-time collaboration tools.

## Platform availability

Available on 1 of 10 platforms: TrueNAS.

## Health score

47/100 (Fair), based on 5 of 5 factors.
- Maintained: 93 (last commit 6 days ago)
- Popular: 38 (83 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Light to run: 10 (8 GB minimum RAM)
- Security check: 15 (2 serious findings, 18 minor, tests)

## Security check

2 serious findings: Uses @feathersjs/authentication-oauth 5.0.35, which has a known critical vulnerability; Uses @feathersjs/mongodb 5.0.35, which has a known critical vulnerability.
Automated checks on commit 23aadeb, 11 Nov 2026. Not an audit.

## Links

- TrueNAS: https://apps.truenas.com/catalog/lens/
- GitHub: https://github.com/FreeCAD/Ondsel-Server

## Common questions

### How do I start the Lens server with or without analytics?

Use docker-compose with the matomo-enabled profile to start it with analytics, or use the normal docker-compose command for no analytics. Rebuild the frontend after changing environment variables.

### How do I configure local Keycloak OIDC for testing?

Start the dev compose stack with the keycloak profile, run the backend seedDevKeycloakOidcSiteConfig migration once, and restart the backend.

### How do I enable AWS S3 storage?

Copy env.with-aws.example to .env instead of env.example before starting the server.

### What if an old Lens backend database exists during manual setup?

Start MongoDB and remove the old od-backend-db database if necessary, for example with MongoDB Compass.

### Do I need to change the default Lens credentials?

The default Matomo, frontend, and Keycloak credentials can be customized in .env. The documentation strongly recommends changing them for production.

---
Source: Our Local Host (https://ourlocalhost.com/app/3718/lens), the self-hosted and open-source app directory.
