Repository navigation
Releases
v0.1.1 — the viewer
A photo or video of a post now opens in a viewer over the page, not in a new window.
What changed
- A viewer over the page. Click a file of a post, in either look, and it opens over the history: the photo fitted to the screen, or the video with its controls.
- The whole post, one file after another. The arrows beside the file, the left and right keys or a swipe on a phone go to the previous and next file of the same post. A counter shows where you are.
- Download from the viewer. The file's name and a download button stay above it.
- Closing it. Esc, the close button or a click beside the file. The video stops when the viewer closes.
- The file itself is still there. A click with Cmd, Ctrl, Shift or Alt, or the browser's "open in new tab", opens the file on its own, as before.
Updating
cd pullpost
git pull
docker compose up -d --buildThe data volume is kept: the history, the password and the settings stay as they were.
v0.1.0 — every photo and video of a post, as files
The first release. pullpost is a small web app you run on your own server: paste the address of an Instagram post and it saves every photo and video in it as a separate file, at the highest resolution Instagram serves, plus one ZIP with all of them.
What it does
- Every file of a post. Each photo of a carousel and each video of a reel.
/p/,/reel/and/tv/addresses work,?img_indexincluded, and so does the post's bare code. - Files and a ZIP. Download one file or all of them. Delete a single file and the ZIP is made again without it.
- Names that sort by date. The post's date comes first, then the account, the post's code and the file's number:
2026-11-18_<account>_<code>_01.jpg. - A history you keep until you delete it, with small pictures, dates and sizes. One post at a time, with the progress on the page while it downloads.
- Two looks: a light table with slides, or a receipt printer. Both follow the light or dark setting of your system.
- English and Romanian, picked from the browser and switchable on every page.
- Your server, your files. No telemetry, no update check, no third-party fonts or scripts. The app talks only to Instagram.
How it runs
Two containers with Docker Compose share one data volume. web is PHP 8.3 with Apache and SQLite. engine is Python (standard library only) driving Debian's Chromium over the DevTools protocol on a pipe, so no debugging port is opened. The engine publishes no port on the host, only the web container reaches it, and Chromium runs with no capabilities, no new privileges and a memory cap. Files are downloaded only from Instagram's CDN.
git clone https://github.com/cremenescu/pullpost.git
cd pullpost
docker compose up -d --build
docker compose logs web # the setup code for the first sign-inThen open http://<this machine>:8080, enter the code, choose the page's password and confirm the notice. The README has the settings, the reverse proxy setup and the everyday commands.
A public demo
PULLPOST_DEMO=1 turns the app into a demo anyone can try, and compose.demo.yaml runs it: the web container alone, without the engine, so the demo never talks to Instagram. The sign-in page shows the demo's password, each visitor keeps their own look, and every hour the history goes back to a snapshot made with bin/demo.php snapshot. See "A public demo" in the README.
Your Instagram account (optional)
Logged out, pullpost sees only what anyone sees without an account. For posts Instagram shows only to someone signed in, you can set the sessionid cookie of your own account in Settings. That is automated access while logged in, which Instagram's terms forbid: read "Your Instagram account" in the README before you do it.
Not there yet
- Prebuilt Docker images: the images are built on your machine.
- The engine as a command-line tool of its own.
Responsible use
For personal use, with content you have the right to keep. Instagram's terms forbid collecting content by automated means without its permission; using the tool may breach them. The README has the details. pullpost is not affiliated with, endorsed by or sponsored by Instagram or Meta Platforms, Inc.
Licensed under GPL-2.0-or-later. The bundled fonts (Schibsted Grotesk, Courier Prime, Martian Mono) are under the SIL Open Font License 1.1.