Repository navigation
integration-proxy: public self-hosting guide (SELF_HOSTING.md), Dockerfile, host-agnostic README (#79) - #131
Merged
Conversation
Builds atomic-integration-proxy from crates.io (PROXY_VERSION, --locked) into a debian:bookworm-slim image with libssl3 and ca-certificates, running as a non-root user. The build context is unused (.dockerignore excludes everything). Not packaged in the crate (Cargo.toml include list) and not built in CI; tested locally: build, start against PostgreSQL 16, /healthz, /catalog. Refs #79. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
SELF_HOSTING.md (fixed path, linked from the connect UI): what the proxy does and doesn't, security model, cargo install / Docker / wrapper crate, every environment variable, PostgreSQL sslmode behaviour (measured: prefer falls back to plaintext against a non-TLS server, require refuses it), ENCRYPTION_KEY generation and the lack of rotation, pinning the catalog to a commit, ALLOWED_AGENTS, Caddy/nginx, a systemd unit (systemd-analyze verify only), per-platform OAuth registration with exact callback and OAUTH_* names, pointing atomic-server (#1702, unmerged) and the data browser at it, upgrades, backups, /healthz behaviour (measured: hangs without a timeout while PostgreSQL is paused; recovers after a restart), limits and what is not verified. README: link the guide; drop the Heroku-only framing of TLS, DATABASE_URL and callbacks; label the Heroku section as the localthought.io deployment. Root README: link the guide. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #79.
Adds
integration-proxy/SELF_HOSTING.md, the public guide that the atomic-server connect UI links to (per Michiel's decision on ontola/atomic-server#1700: self-hosted servers default to atomic.place's proxy). Its URL is fixed at https://github.com/ontola/atomic-plugins/blob/main/integration-proxy/SELF_HOSTING.md.cargo install atomic-integration-proxy --version 0.2.0 --locked; the crate already ships theintegration-proxybinary;DATABASE_URLandsslmode: tested against Postgres 16. The defaultpreferworks locally but can be downgraded to plaintext across a network, so userequirethere;ENCRYPTION_KEY: there's no rotation, and changing it drops every connection;SESSION_SECRET;BASE_URL, which must be exact, with Caddy and nginx examples;CATALOG_PATH, including pinning the catalog to a commit, which was tested;REVOKED_SUBJECTSandALLOWED_AGENTS: if everyALLOWED_AGENTSentry is invalid, nobody is admitted.<BASE_URL>/oauth/<platform>/callbackand the exactOAUTH_<PLATFORM>_*variables.--integration-proxy-url/ATOMIC_INTEGRATION_PROXY_URL(#1702, still open);VITE_INTEGRATION_PROXY_URL;ENCRYPTION_KEYtogether), and/healthzmonitoring./healthzhas no internal timeout, so monitors must set one.DATABASE_URL, callbacks) are made host-agnostic, and the Heroku section is renamed to describe the localthought.io deployment.Not verified: the systemd unit is checked with
systemd-analyze verifyonly; the Caddy and nginx configs, other Postgres versions and Postgres with TLS are untested; no live OAuth connect was made; and the providers' console links and quirks weren't re-checked against their current docs. The guide says all of this.No Rust code changed.
🤖 Generated with Claude Code