Facet

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

Facet

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

Links

Details

Repository
ghcr.io/jesposito/facet:latest
Last Updated2026-11-22
First Seen2026-01-21

Runtime arguments

Web UI
http://[IP]:[PORT:8080]/
Network
bridge
Shell
sh
Privileged
false

Template configuration

Web UI PortPorttcp

Host port mapped to the Facet web UI (Caddy listens on 8080 inside the container).

Target
8080
Default
8080
Value
8080
App DataPathrw

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
Uploads StoragePathrw

Path to uploaded images and files.

Target
/uploads
Default
/mnt/user/appdata/facet/uploads
Value
/mnt/user/appdata/facet/uploads
Public URLVariable

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
Admin EmailsVariable

Comma-separated email allowlist for OAuth login. Leave empty to allow any email.

Target
ADMIN_EMAILS
Behind ProxyVariable

Set to true if running behind a reverse proxy (NPMplus, Traefik, Cloudflare Tunnel).

Target
TRUST_PROXY
Default
false
Value
false
OAuth - Google - Client IDVariable

Client ID for Sign in with Google. Redirect URI: YOUR_URL/api/oauth2-redirect

Target
GOOGLE_CLIENT_ID
OAuth - Google - Client SecretVariable

Client secret from Google Cloud Console.

Target
GOOGLE_CLIENT_SECRET
OAuth - GitHub - Client IDVariable

Client ID for Sign in with GitHub. Redirect URI: YOUR_URL/api/oauth2-redirect

Target
GITHUB_CLIENT_ID
OAuth - GitHub - Client SecretVariable

Client secret from GitHub OAuth Apps.

Target
GITHUB_CLIENT_SECRET
AI - OpenAI - API KeyVariable

API key for OpenAI assist (optional).

Target
OPENAI_API_KEY
AI - Anthropic - API KeyVariable

API key for Anthropic assist (optional).

Target
ANTHROPIC_API_KEY
AI - Ollama - URLVariable

URL for local Ollama instance (e.g. http://192.168.1.100:11434).

Target
OLLAMA_BASE_URL
AI - Ollama - ModelVariable

Ollama model name.

Target
OLLAMA_MODEL
Default
llama3.2
Value
llama3.2
PUIDVariable

User ID for file permissions.

Default
99
Value
99
PGIDVariable

Group ID for file permissions.

Default
100
Value
100
Admin UI EnabledVariable

Enable PocketBase admin UI at /_/ for debugging. Leave false in production.

Target
ADMIN_ENABLED
Default
false
Value
false