Self-hosted, resource aware file conversion server that supports 490+ formats in 26 languages.
50K+
Convert almost anything, on your own server. Nothing ever leaves it.
A self-hosted file converter for the public internet, with every converter locked in a sandbox.
490+ formats · 26 languages · runs on a Raspberry Pi
multi-step workflows · optional accounts · no cookies, database or tracking
Get Started · Docker Image · Documentation · Security Policy
Seven colour schemes, two interfaces and 26 languages, with right-to-left layouts where a language needs one.
Free online converters are paid for with your files. Upload a contract, a medical scan or a client's CAD drawing and it now sits on a stranger's server, next to an ad network.
HRConvert2 gives you the same convenience with none of that. Drag a file in, pick a format, download the result. The conversion happens on hardware you control, your visitors need no account, and their files are deleted on a schedule you set.
| Promise | What it means |
|---|---|
| 🏠 Nothing transmitted | Every conversion runs on your server, with local tools. No CDN, no analytics, no telemetry. |
| 👤 No cookies, no account needed | Visitors are anonymous, and each gets an isolated folder nobody else can see. Optional accounts, off by default, let a user keep files of their own, still without a cookie. |
| 🗑️ Files expire | Uploads and results are deleted automatically after an age you choose, unless a signed-in user keeps them. |
| 🧱 Sandboxed converters | Every tool that parses an upload runs in a bubblewrap sandbox with no network. |
| 🌍 Built for strangers | Designed to be put on the public internet and attacked, and documented that way. |
|
|
Every conversion travels the same path:
flowchart LR
A["Browser<br/>no cookie"] -->|upload| B["HRConvert2"]
B --> C["Pipeline<br/>image, video, document, 3D ..."]
C --> E
subgraph S["bubblewrap sandbox, no network"]
E["ImageMagick, FFmpeg,<br/>LibreOffice, OpenSCAD ..."]
end
The result comes back the same way, and expires on the schedule you set.
A workflow is a list of steps, each one something you could already do with a button. Convert every document to PDF, then put the PDFs in one zip is a workflow of two steps. Start it once and it does every step. Each step runs the same code as its button, under the same limits, so a workflow can do nothing a visitor could not already do by hand.
{
"Format": "HRProprietary Workflow",
"Version": 1,
"Name": "Documents to PDF, in one zip",
"Description": "Converts every selected document, spreadsheet & presentation to PDF, then puts the PDFs in one zip archive.",
"Steps": [
{ "Operation": "Convert",
"Filter": { "Types": ["Document", "Spreadsheet", "Presentation"] },
"Options": { "Extension": "pdf" } },
{ "Operation": "Archive", "Mode": "together",
"Options": { "Extension": "zip", "Filename": "Documents" } }
]
}
See ABOUT_WORKFLOWS for the format, the libraries and every limit.
Accounts are off by default, and an installation that leaves them off works exactly as it always has. Turn them on and your users can sign in and keep their files between visits.
window.name, never in a cookie, site storage, a URL or a log. The page trades it for a new one every few seconds. A stolen copy soon expires, and since each key can be traded only once, trading it signs out both the thief and the user. Close the tab and you are signed out.%%{init: {"sequence": {"mirrorActors": false}}}%%
sequenceDiagram
participant T as Your browser tab
participant H as HRConvert2
T->>H: Sign in
H-->>T: A key that lives 30 s
loop Every 6 s, by default
T->>H: Trade the key
H-->>T: A new key
end
Note over T,H: Kept in the tab, never in a cookie
Serve HRConvert2 over HTTPS, then turn accounts on with sudo php convertCore.php --config, under Enable Authentication. ABOUT_AUTHENTICATION says what accounts defend against, and what they do not.
sudo git clone https://github.com/zelon88/HRConvert2 /opt/HRConvert2
sudo bash /opt/HRConvert2/Documentation/Build/hrconvert2-setup.sh
Two commands. Clone where only root can change it, such as /opt, because root will not install a tree another account could change. The installer pulls every dependency, creates the storage, sets up the AppArmor profile, PHP and the systemd units, installs HRConvert2 beside its storage, outside the web root, puts in the web root only what a browser needs, then tells you exactly what is working. Add -y to skip the confirmations.
Then open http://your-server/HRProprietary/HRConvert2/convertCore.php and start converting.
docker run -d -p 8080:80 --cap-add SYS_ADMIN -v hrconvert2-data:/DATA/HRConvert2 zelon88/hrconvert2
SYS_ADMIN lets the container build the sandbox every converter runs in. Leave it off and the container cannot build one. No process that converts or serves a user's file holds SYS_ADMIN, or any other capability. Run php convertCore.php -v inside the container to confirm the sandbox works. The named volume keeps sessions, accounts and their files when you replace the container to update, and DOCKER_BUILD_INSTRUCTIONS lists what else to keep, such as your settings.
cd /var/www/html/HRProprietary/HRConvert2
sudo php convertCore.php -v # Check every component & say what is wrong
sudo php convertCore.php -fp # Repair permissions & the web server setup
| Category | Examples |
|---|---|
| Documents | doc, docx, odt, rtf, txt, pdf |
| Spreadsheets | xls, xlsx, ods, csv |
| Presentations | ppt, pptx, odp |
| Images | jpg, png, gif, webp, heic, avif, svg, ico, tiff |
| Video | mp4, mkv, avi, mov, webm, flv, and 50+ more |
| Audio | mp3, flac, aac, wav, opus, wma, and 30+ more |
| Subtitles | srt, vtt, ass, sub, sbv, ttml, and more |
| E-Books | epub, mobi, azw, azw3, azw4 |
| Archives | zip, rar, 7z, tar, gz, bz2 |
| Extract | Every file an archive holds, placed beside it, within the size & count limits you set |
| 3D Models | obj, stl, ply, collada, and OpenSCAD sources |
| Drawings & Vectors | dxf, dia, vdx, svg |
| Bootable Disk Images | x86, ARM, UEFI and MBR/GPT hybrid ISOs |
| OCR | Extract text from images and PDFs |
| Identify | Size, type, character set & hashes of any file, and whether its name matches what it holds |
| Strip Metadata | A copy of a photo, PDF, office document, ebook, song or video without its authors, places, dates or the software that made it |
| Merge & Split PDFs | Put several PDFs into one, or make a PDF of each page |
| Rename & Delete | Rename one file or every selected file from a pattern, keeping each extension, or delete a selection |
| Workflows | Any of the above, chained into one run. See Workflows. |
| Live Streams | Capture and convert m3u8 playlists |
| Remote Files | Fetch a file from a URL. Off by default. |
HRConvert2 assumes every tool that parses a hostile file can be exploited. So the sandbox is the security boundary, and everything else is a layer on top of it.
Visitors switch language from the page. Nothing to install.
English · Français · Español · 中文 · हिन्दी · العربية · Русский · Українська · বাংলা
Deutsch · 한국어 · Italiano · Português · Tiếng Việt · Türkçe · 日本語 · Bahasa Indonesia
Polski · Nederlands · Kiswahili · မြန်မာ · اردو · فارسی · עברית · ܣܘܪܝܝܐ · ܐܪܡܝܐ
Arabic, Hebrew, Persian, Urdu and both Syriac script languages get proper right-to-left layouts. A new language is one folder, with no change to the core.
--pipeline.-v names every pipeline it cannot offer, and what it is missing.php convertCore.php -u stages a release, swaps it in, and validates it. If the new version can't run, it rolls back on its own. Your configuration is kept.config.php.Everything is manageable from the terminal, as root:
php convertCore.php -v # Check every component, dependency & feature
php convertCore.php --status # System state & the listener
php convertCore.php --config # Interactive configuration
php convertCore.php --config --repair # Add any setting the configuration is missing
php convertCore.php --setup --check-depends # Audit every dependency
php convertCore.php --pipeline --verify # Confirm every pipeline loaded
php convertCore.php --workflow --list # List workflows, & why any is not offered
php convertCore.php --workflow --install=FILE # Check a workflow & offer it to every user
php convertCore.php --workflow --install-staged=ID # Install a workflow an admin staged from the page
php convertCore.php --workflow --discard-staged=ID # Turn a staged workflow down & install nothing
php convertCore.php --workflow --export=ID # Print a workflow as a file a page can import
php convertCore.php --account --list # List accounts, roles & last sign-ins
php convertCore.php --account --add NAME EMAIL # Make an account & show its password once
php convertCore.php --account --password NAME # Give an account a new password & show it once
php convertCore.php -u=latest # Update to the newest release
php convertCore.php -c # Clean every expired session now
Every command exits with a status a script can act on. See the full command reference.
| Minimum | |
|---|---|
| OS | Debian or Ubuntu Linux |
| Web server | Apache 2.4 |
| PHP | 8.0 or later |
| Hardware | Raspberry Pi Model B+. Any x86 or x64 machine is comfortable. |
| Sandbox | Bubblewrap |
| Optional. A local mail system, for confirming email addresses and recovering passwords. HRConvert2 installs none. |
The installer handles every dependency. The authoritative list is depends.php.
php convertCore.php -v.GNU General Public License v3.0. Free to use, free to modify, free to self-host. If you improve it, send it back.
Built by @zelon88 for people who would rather not hand their files to strangers.
Content type
Image
Digest
sha256:6bdc47010…
Size
2.3 GB
Last updated
1 day ago
docker pull zelon88/hrconvert2