pullpost

Save the photos and videos of an Instagram post as files, at the highest resolution Instagram serves, on your own server.

Docker Compose · PHP 8.3 + headless Chromium · English & Romanian · GPL-2.0-or-later

Screenshots

pullpost, light table look: a carousel of six pictures laid out as slides, the third one circled, with the post details and the download buttons on a typed card.

The light table: every file of the post as a slide, the one the link pointed at circled, the details and the ZIP on a typed card.

pullpost, receipt look: the same carousel printed as a receipt, one line per file with its size, and the ZIP as a coupon.

The receipt printer: one line per file, the ZIP as a coupon.

pullpost, receipt look in dark mode, showing a reel with one video.

A reel, receipt look in dark mode.

pullpost history page in dark mode: four saved posts with their small pictures, dates and sizes.

The history, light table look in dark mode. The pictures and the video are synthetic landscapes and gradients made for these shots, under a made-up account; no real Instagram post appears here.

What is pullpost?

You paste the address of a post, a reel or a /tv/ link. The server opens it in a headless Chromium, logged out, reads the post's data from the page and downloads every photo and video from Instagram's CDN, choosing the largest version of each. You get each file on its own and one ZIP with all of them, and the post stays in your history until you delete it.

File names start with the date of the post, so they sort by date in a folder: 2026-11-18_<account>_<code>_01.jpg.

Try the demo

The demo runs the code from GitHub with its demo switch on. Everything works except fetching from Instagram: open the saved posts, download the files and the ZIPs, delete things, change the look and the language. It goes back to how it started every hour. The posts in it are public posts of NASA's Instagram account, saved with pullpost; NASA has nothing to do with this project.

Password: pullpost · open the demo

Features

How it works

Two containers share one data volume. web is PHP 8.3 with Apache and SQLite: the pages, the history, the files and the ZIPs. engine is Python (standard library only) with Debian's Chromium, driven over the DevTools protocol on a pipe, so no debugging port is opened. Media is downloaded only from Instagram's CDN hosts; any other address, or a redirect elsewhere, is refused.

The engine has no port of its own on the host: only the web container reaches it. Chromium runs in a container with no capabilities, no new privileges and a memory cap.

Install

  1. You need Docker with Compose v2. Clone the repository and start it:
    git clone https://github.com/cremenescu/pullpost.git
    cd pullpost
    docker compose up -d --build
  2. Read the setup code from the log:
    docker compose logs web
  3. Open http://<this machine>:8080, enter the code, choose the password for the page and confirm you have read the notice. The code proves the server is yours and is deleted once the password is set.
Behind a reverse proxy. The app has its own password, but it is meant for a home network or for a proxy that adds HTTPS, not for a port open to the internet. The README lists the settings for that, the port and the time zone used in file names.

Your Instagram account (optional)

Logged out, pullpost sees only what anyone sees without an account. For posts that Instagram shows only to a signed-in user you can paste the sessionid cookie of your own account in Settings; the engine still tries every post logged out first. That is automated access while logged in, which Instagram's terms forbid: Instagram may ask for checks, limit or disable that account, and the cookie is a full login to it.

Responsible use

What's not yet there

License & credits

pullpost is released under GPL-2.0-or-later. The fonts it ships (Schibsted Grotesk, Courier Prime, Martian Mono) are under the SIL Open Font License 1.1.

Not affiliated with, endorsed by or sponsored by Instagram or Meta Platforms, Inc. "Instagram" is a trademark of Meta Platforms, Inc. and appears here only to say what the tool works with.

Changelog

From the GitHub releases, newest first.

v0.1.1 · 2026-11-19

The viewer.

  • A viewer over the page: a photo or video of a post opens over the history, not in a new window, with the download button above it.
  • The whole post: the arrows, the left and right keys or a swipe on a phone go to the previous and next file of the same post.

v0.1.0 · 2026-11-19

The first release.

  • Every file of a post: each photo of a carousel and each video of a reel, at the highest resolution Instagram serves, as separate files and one ZIP, with names that sort by date.
  • Docker Compose: a PHP web app and an engine with headless Chromium, which publishes no port of its own.
  • Two looks and two languages: a light table or a receipt printer, each light or dark; English and Romanian.
  • A demo mode: PULLPOST_DEMO=1, without fetching, which runs the demo linked from this page.

Feedback

Bugs and feature requests: issue tracker.
Direct contact: razvan@cremenescu.ro.