Facet
Docker app from jesposito's Repository
Facet is a self-hosted personal profile platform.
Overview
Facet is a self-hosted personal profile platform. Create multiple views of your professional profile for different audiences (recruiters, conferences, clients) and own all of your data.
Each view is a curated slice of your full profile: a recruiter sees roles and references, a conference organizer sees talks and bio, a client sees portfolio and rates. You decide what each audience sees and they only see what you've shared.
First-time login: visit /admin, sign in with the first email from Admin Emails (or admin@example.com if blank) and the seeded password printed in the container logs. You will be forced to set a new password immediately.
Features:
- Multiple profile views per person
- OAuth login via Google or GitHub (optional)
- Optional AI assist via OpenAI, Anthropic, or local Ollama
- All data stays on your server
- Single Docker container, embedded SQLite database
Readme
View on GitHubFacet
Join the Facet HQ Discord Latest version License: MIT Docker image Build Go Svelte 5 Self-hosted
Every side of you. Your way.
Facet is a personal website you host yourself: your profile, work history, projects, writing and talks in one place, with a different view for each audience. A recruiter sees your employment history. A conference organiser sees your talks. A client sees case studies and testimonials. You write everything once.
Everything lives in a SQLite database and an uploads folder on your own machine. There's no Facet account and no telemetry.
What it does
- Facets: pages such as a résumé, client proposal or project collection, each with its own address, content and presentation. Share a page on its own, add it to site navigation, or use it both ways (examples)
- Visibility you control: public, unlisted views behind share links that can expire, password-protected views, and private items
- Content: experience, projects, education, certifications, awards, skills, posts, talks, testimonials and your own custom sections
- Project experiences: turn a project into a case study, video course or code walkthrough
- Imports: pull projects from GitHub, or turn an existing résumé into structured content
- Optional AI, using your own Anthropic, OpenAI, compatible or local Ollama provider: a writing assistant, résumé import, GitHub summaries and tailored résumé PDFs
- Testimonials, comments and a newsletter, moderated by you
- Feeds and portability: RSS, an iCal file of your talks, a sitemap, JSON/YAML export, and a scoped REST API with signed webhooks
- Two-factor sign-in, built-in daily backups, and interface translations including German, Elvish, Klingon and LOLcat
- Room to make up fake people, like some kind of weirdie: the built-in demo profile belongs to a 900-year-old Time Lord
Newer areas, notably payments, courses and the newsletter, have limits worth reading about first. The roadmap lists what works and what doesn't yet.
Try it
You need Docker. This runs Facet on your own computer only:
docker run -d --name facet -p 127.0.0.1:8080:8080 \
-v facet-data:/data -v facet-uploads:/uploads \
ghcr.io/jesposito/facet:3
Facet creates an admin@example.com account with a random password in /data/.admin-credentials (mode 0600), not in the log. Read it with docker exec facet cat /data/.admin-credentials, then open http://localhost:8080/admin and sign in. Change the password under Settings, then delete the handoff file with docker exec facet rm /data/.admin-credentials. The demo toggle in the admin header loads a complete sample site to explore.
To keep Facet running properly, with your own email as the login, a domain and backups, follow the install guide.
Self-hosted Facet and Facet Cloud
This repository is self-hosted Facet, free and MIT-licensed, and you run it. Facet Cloud is a separate hosted service. It's related to this project but runs its own code, with its own features, pricing and data handling, and it isn't covered by the documentation here.
Documentation
Running Facet: Install and first login · Configuration · Putting it on the internet · Upgrades, backups and recovery · Security and privacy · Troubleshooting
Using Facet: Features · Project experiences · Media · Newsletter, payments and courses · AI features · API and webhooks
Working on Facet: Contributing · Development guide · Architecture · Design principles · Translations
The documentation index lists every page.
Built with
Go and PocketBase with SQLite on the backend, SvelteKit and Tailwind CSS on the frontend, and Caddy in front, all in one container. For development on Linux, make dev starts everything with hot reload. See the development guide.
Support the project
If Facet saves you time or helps your career, you can buy me a coffee. Bug reports, ideas and pull requests are just as welcome: open an issue or say hello on Discord.
Licence and credits
MIT. See LICENSE. Bundled third-party code keeps its own licence notices, for example in frontend/vendor.
Built by jesposito, on the shoulders of PocketBase, SvelteKit, Caddy and too much coffee.
Categories
Related apps
Explore more like this
Explore allLinks
Details
ghcr.io/jesposito/facet:latestRuntime arguments
- Web UI
http://[IP]:[PORT:8080]/- Network
bridge- Shell
sh- Privileged
- false
Template configuration
Host port mapped to the Facet web UI (Caddy listens on 8080 inside the container).
- Target
- 8080
- Default
- 8080
- Value
- 8080
Path to app data (SQLite database and configuration). Include this in backups.
- Target
- /data
- Default
- /mnt/user/appdata/facet/data
- Value
- /mnt/user/appdata/facet/data
Path to uploaded images and files.
- Target
- /uploads
- Default
- /mnt/user/appdata/facet/uploads
- Value
- /mnt/user/appdata/facet/uploads
Public URL for Facet (e.g. http://YOUR-SERVER-IP:8080 or https://facet.example.com). REQUIRED if you want OAuth sign-in or to share profile links externally. Used as the OAuth callback host and the base for share URLs.
- Target
- APP_URL
Comma-separated email allowlist for OAuth login. Leave empty to allow any email.
- Target
- ADMIN_EMAILS
Set to true if running behind a reverse proxy (NPMplus, Traefik, Cloudflare Tunnel).
- Target
- TRUST_PROXY
- Default
- false
- Value
- false
Client ID for Sign in with Google. Redirect URI: YOUR_URL/api/oauth2-redirect
- Target
- GOOGLE_CLIENT_ID
Client secret from Google Cloud Console.
- Target
- GOOGLE_CLIENT_SECRET
Client ID for Sign in with GitHub. Redirect URI: YOUR_URL/api/oauth2-redirect
- Target
- GITHUB_CLIENT_ID
Client secret from GitHub OAuth Apps.
- Target
- GITHUB_CLIENT_SECRET
API key for OpenAI assist (optional).
- Target
- OPENAI_API_KEY
API key for Anthropic assist (optional).
- Target
- ANTHROPIC_API_KEY
URL for local Ollama instance (e.g. http://192.168.1.100:11434).
- Target
- OLLAMA_BASE_URL
Ollama model name.
- Target
- OLLAMA_MODEL
- Default
- llama3.2
- Value
- llama3.2
User ID for file permissions.
- Default
- 99
- Value
- 99
Group ID for file permissions.
- Default
- 100
- Value
- 100
Enable PocketBase admin UI at /_/ for debugging. Leave false in production.
- Target
- ADMIN_ENABLED
- Default
- false
- Value
- false