Installing Postulo
Tiago Águeda edited this page 2026-11-11 16:16:47 +01:00

Page revisions

27 Commits

Author SHA1 Message Date
abeb4896d8
Name the two new warnings, and what is read once and kept
Configuration and Installing Postulo name postulo.W003 and postulo.W004, give
the occupations file its new size, and say when the Overview asks the fonts
again. Writing a plugin says that the primary number and link of a contact
are read from prefetched rows.

Refs postulo/postulo#1109
Refs postulo/postulo#1110
Refs postulo/postulo#1171
Refs postulo/postulo#1133

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-11 16:16:47 +01:00
3fc93f2098
Describe saving a setting with no connection, and the script build
Accessibility says that a setting changed while Postulo cannot be reached is
kept and sent when the connection returns. Design and Installing Postulo say
that the page script is built from assets/js/app.js and committed, as the
stylesheet is.

Refs postulo/postulo#1157
Refs postulo/postulo#1149

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-11 16:15:37 +01:00
c5c4e96529
Installing the app: how to install Postulo, what it does offline, what the proxy must pass
Refs postulo/postulo#895

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 13:14:22 +02:00
ee6e8bd0e9
Correct the pages for the Hardening, Career ordering, Installing, Configuration, plugin, Roadmap and Troubleshooting issues
Refs postulo/postulo#537 postulo/postulo#613 postulo/postulo#540 postulo/postulo#584 postulo/postulo#404 postulo/postulo#405 postulo/postulo#406 postulo/postulo#765 postulo/postulo#745 postulo/postulo#764

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-12 08:48:16 +02:00
2d14763e8a Say that the image now carries the CJK fonts and which scripts it draws (#728)
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-07 11:14:28 +02:00
a324b4a6a6
Your own email now sends from the record page; company names are compared without capitals
Configuration, Writing-a-plugin, Files-and-what-you-sent: the Email these step on Record what
you sent (sent first, frozen and recorded only if it went, an outbox plugin raises on failure).
Installing-Postulo: company and department names are unique ignoring capitals and spacing, the
upgrade stops and lists any clash, and manage.py company_name_clashes lists them beforehand.

Refs postulo/postulo#361 postulo/postulo#546

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-04 16:14:09 +02:00
adac8dd859
Installing, Backups: source builds have their own image name, a PostgreSQL restore is all or nothing
Installing-Postulo: the install checks out the latest release tag; a source build is the base
file plus the build override and is tagged postulo:local, so one upgrade path per kind of
install and a pull can never replace a source build. Backups-and-your-data: on PostgreSQL a
restore runs in one transaction that stops at the first error and leaves the database as it was.

Refs postulo/postulo#403 postulo/postulo#477

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-04 15:28:20 +02:00
41afccc105
Installing, Configuration, Hardening: the PostgreSQL file, the worker, the :0.3 image, one upgrade path per install
The PostgreSQL install reads POSTGRES_PASSWORD from the root .env and has a worker of its own;
every command names the file the instance was started with. The image pin is :0.3 and the
registry and source-build upgrade paths are told apart and never combined. Your own email starts
on STARTTLS and refuses a password in the clear; the operator's host exemption is for the
instance's own transport only; a redirect on a pinned request keeps the site's name; a stop
signal ends the worker and a killed worker's errands are failed after a day.

Refs postulo/postulo#581 postulo/postulo#582 postulo/postulo#403 postulo/postulo#358
Refs postulo/postulo#360 postulo/postulo#363 postulo/postulo#474 postulo/postulo#539

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-04 12:04:57 +02:00
0ab6c352f0
Hardening, Configuration, Installing: what the server dials, and the GeoNames switch
Capture is no longer called the only outbound request; Hardening lists what the core dials and
what turns each off; Configuration gains POSTULO_SKIP_GEONAMES and says the entrypoint follows
POSTULO_GEOLOCATIONS_DIR.

Refs postulo/postulo#366

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-04 10:53:46 +02:00
6ace621586
Importers that raise, and fetch_esco deleting the replaced revision
Refs postulo/postulo#611
Refs postulo/postulo#535

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-04 06:18:36 +02:00
b0743e92ea
Say that the ESCO classification files live on the data volume
Installing Postulo: the files are written under POSTULO_ESCO_DIR (/app/data/esco in the
image), so a new image or a rebuild no longer asks for fetch_esco to be run again.

Refs postulo/postulo#411

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 19:21:53 +02:00
ad68c39b2a
Constrain the image-on-top examples and name the git URL
Refs postulo/postulo#542
2026-10-03 18:58:54 +02:00
faefabcd2c
Say what a fetch refuses, how long it waits, and what an import does with a username
Addresses that carry a private one are refused; a page, its robots.txt
and a logo are held to a whole-download time as well as a size; only
gzip and deflate are unpacked; an archive's username is taken only when
the rules allow it; and Python 3.12.4 is the oldest Python.

Refs postulo/postulo#321

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 15:27:01 +02:00
b4e6b0e3bd
Say what the foot of every page shows, and what it no longer tells a stranger
Configuration gains the two settings the footer reads (where its source
code is, and a legal notice when there is one) and a section on what
the foot of every page holds. Hardening gains *What a stranger is
told*: the version is shown only to people signed in, and `/healthz`
still reports it for monitoring. Installing Postulo and Troubleshooting
stop saying the version is in the footer for everybody, and Installing
says a modified Postulo should point `POSTULO_SOURCE_URL` at its code.

Refs postulo/postulo#212

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 19:21:04 +02:00
75174c4f23
Say how a skill's name is recognised as an ESCO skill, and what a CV prints for it
Your career record gains *Skills the classification knows*: the box
offering the classification's names as you type, what recognition
means and what it never guesses, and skills recorded before it. It
also says a skill the classification knows is the one exception to an
untranslated entry printing its original, and that a candidate file is
now format 2 and carries the identifier without ever reading it back.

CVs says when a CV in another language prints the classification's name
for a skill. Installing Postulo says the classification is two files,
written together or not at all, and Configuration gains the rate limit
on the skill box's suggestions.

Refs postulo/postulo#266

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-29 19:10:37 +02:00
368df945f6
Say what a cached build means for the image's packages
Hardening said a fresh build takes whatever Debian has published, and
that rebuilding is how an instance gets patched. Both are true of a
build that runs the layer, and a machine that has built before does not
run it: Docker hands back the layer it kept, with the packages of that
day. The page now says so, shows the build argument that makes the
layer run again, and what the layer prints either way.

Installing Postulo's upgrade recipe builds with the argument, where it
had `up -d --build`, which is the cached build.

Refs postulo/postulo#300

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-29 08:39:44 +02:00
a0eb531e53
Document the ESCO download, and the file's home in the container 2026-09-24 15:42:09 +02:00
d7de1df25a
Document the fonts the image carries, and the door for CJK
The page names the two font packages the image ships and the scripts they cover, says CJK is a deliberate absence and how to opt in, and points at manage.py check_fonts and Server settings to Overview for the answer a running instance can give.

Refs postulo/postulo#74

Co-Authored-By: Cline <noreply@cline.bot>
2026-09-23 17:55:28 +02:00
485c096f1f
Document the opt-in update check
Refs postulo/postulo#272

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-19 12:50:46 +02:00
705adf4886
Name the proxy: only this host is trusted by default now
Refs postulo/postulo#232

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-19 10:51:56 +02:00
61eb362fbb
Say that a release carries the image's bill of materials
Refs postulo/postulo#251

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-18 11:41:00 +02:00
2d4c0c70de
Take the pages over from postulo/wiki, which this repository now replaces
Until now this was a copy of postulo/wiki, refreshed by postulo's
scripts/publish-wiki.sh whenever somebody remembered to run it. The last
time was 5 September (postulo@9645ee1). This brings it to postulo@b6cfb8f7:

- the four pages that never arrived: Accessibility, Hardening, Listings
  and Reports;
- the seventeen that had changed since;
- the images, which the script never copied because it copied *.md and
  nothing else, so Home has shown its logo and its Buy me a coffee button
  broken since the day they were added.

Nothing here was lost: every earlier commit is a publish, and the pages
they left matched postulo/wiki at 9645ee1 exactly.

From here pages are written in this repository and nowhere else.

Refs postulo/postulo#169

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-10 13:55:38 +02:00
eb503b888d
Update wiki from postulo@060a8b9 2026-09-04 23:06:09 +02:00
41b59eee9c
Update wiki from postulo@c2bf88c 2026-09-04 21:33:06 +02:00
514afd10e7
Update wiki from postulo@7675bf1 2026-09-04 21:29:59 +02:00
8587879b04
Update wiki from postulo@e19350f 2026-09-04 20:35:10 +02:00
ef61de01eb
Update wiki from postulo@036d3d3 2026-09-04 19:54:11 +02:00