Write the template in Word, Excel or PowerPoint. One request fills the tags, converts the result to PDF and finishes it, in a single container on your own servers.
{{ seller.name }} Invoice {{ number }} Billed to {{ customer.name }} {% for item in items %}{{ item.name }} {{ item.qty }} × {{ item.price }}{% endfor %} Total due {{ total | currency(currency) }} {{ payment_url | barcode("qr", size=90) }}
{
"number": "INV-2041",
"customer": { "name": "Amani Otieno" },
"items": [ 3 items ],
"total": 36300
}POST /v1/render
The layout stays in a file someone can edit, and your application sends data.
Invoices
Fill the Word invoice your finance team already uses, print a QR code to pay, and embed Factur-X XML for e-invoicing.
{{ payment_url | barcode("qr", size=90) }}Reports
Fill rows in an Excel sheet with its formulas still working, add a native chart, then convert the workbook to PDF.
{% for r in rows %}{{ r.month }} {{ r.sales }}{% endfor %}Forms
Fill the fields of an existing PDF form from JSON, then flatten it so nobody can change the values.
-F template=@application.pdf -F steps=flattenUse one, or chain them all. Every block works the same in the HTTP API and the CLI.
Tags keep the document’s own formatting, even where Word splits one across runs. Where a loop’s tags sit decides what repeats: text, table rows, paragraphs, sheet rows or slides.
# A table row in invoice-template.docx, a tag per cell
{% for item in items %}{{ item.name }}
{{ item.qty }}
{{ item.price | currency(currency) }}{% endfor %}
# Elsewhere in the same document
Issued {{ issued | date("%d %B %Y") }}
{% if total > 100000 %}Payment due in 14 days{% endif %}Filters place a logo, a QR code or barcode, a link, coloured text, a native chart or a safe subset of HTML where the tag stands.
{{ logo | image(width=120) }}
{{ payment_url | barcode("qr", size=90) }}
{{ sku | barcode("code128") }}
{{ payment_url | link("Pay now") }}
{{ status | color("#c00") }}LibreOffice turns the filled file into a PDF or another Office format, and Fulgur lays out HTML written for print. Neither can reach the network while it works. Send several files and get them back merged or as a ZIP.
# Fill and convert in one call
curl http://localhost:9027/v1/render \
-F template=@invoice-template.docx \
-F "data=<invoice.json" \
-F steps=convert -o invoice.pdf
# Or convert files you already have
curl http://localhost:9027/v1/convert \
-F files=@report.docx -F files=@deck.pptx \
-F merge=true -o bundle.pdfList the steps, and each one works on the result of the last. Stamp it, set its metadata and encrypt it, without another library in your app.
convertpdfapdfuamergesplitwatermarkstamprotateflattenoptimizebookmarksmetadataembedfactur-xencrypt
curl http://localhost:9027/v1/render \
-F template=@invoice-template.docx \
-F "data=<invoice.json" \
-F steps=convert,stamp,metadata,encrypt \
-F stampSource=text -F stampExpression=PAID \
-F 'metadata={"Title":"Invoice INV-2041"}' \
-F userPassword=open-sesame -o invoice.pdfSend one template and a list. You get one finished file per element, named from the data, in a single ZIP.
curl http://localhost:9027/v1/render/batch \
-F template=@letter.docx \
-F "data=<customers.json" -F splitBy=customers \
-F 'batchName={{ item.name }}' \
-F steps=convert -o letters.zipGet the document in the response. Or add a webhook header: the service answers at once and posts the document to your URL when it’s ready.
curl http://localhost:9027/v1/render \
-H "X-Rusticdoc-Webhook-Url: https://receiver.example.com/documents" \
-H "X-Rusticdoc-Webhook-Error-Url: https://receiver.example.com/failures" \
-F template=@invoice-template.docx \
-F "data=<invoice.json" -F steps=convertOne image and one binary. Replicas share nothing but a bucket.
Everything the service needs is in one hardened image. No Node, Java or Chromium.
docker run -p 127.0.0.1:9027:9027 ghcr.io/vmosoti/rusticdoc:0.1.0Run it in Docker Point every replica at one S3 bucket or shared volume. Upload a template to one, and render it from any.
RUSTICDOC_STORE=s3://my-bucket/rusticdocRun many containers The same binary renders on your machine or in a CI job, with no server. Converting needs LibreOffice installed.
rusticdoc render letter.txt --data data.json --steps convert -o letter.pdfUse the CLI A document service reads hostile files by design. These attacks were run at full size against a container limited to 3 GiB, before and after the fixes.
| Attack | Before | Now |
|---|---|---|
| 40 doublings of a template variable | Killed, out of memory | 413 in under a second |
| 40 concurrent 60 MB uploads | Killed, out of memory | Refused at a 1.31 GiB peak |
| 840,000 same-named form parts | No answer in 150 s | 400 in 6 ms |
| Stylesheet link in a converted HTML file | Fetched by LibreOffice | No request leaves |
Service secrets in /proc/1/environ | Readable by LibreOffice | Permission denied |
Something else? Ask on GitHub.
Yes. Everything on this site is in the Apache-2.0 build, including images, barcodes, charts, HTML, PDF forms and webhooks. There is no paid edition.
HTML you write for print, yes: Fulgur lays out its CSS, page rules and images without a browser. Live web pages, no: nothing fetches a URL or runs JavaScript, so a page that needs them needs a tool that runs a browser.
Not to render. Only webhooks and downloadFrom make outbound requests, and RUSTICDOC_OUTBOUND_PROXY can send them through your proxy. LibreOffice can’t reach the network at all.
Version 0.1 is the first release. The service, CLI and template engine are built and tested, but nothing has been opened in Office for Windows or in Acrobat yet. The status page lists what has and hasn’t been checked.
Office templates show whatever the installed fonts cover, and you can upload more fonts as a ZIP. Text the service draws into a PDF itself, such as a stamp or a form value, is Latin only for now.
Not yet. Any HTTP client works, since every request is one multipart form, and the OpenAPI description is there to generate a client from.
The quickstart goes from nothing to a filled invoice in a few commands, with a sample template and data to download.
# Start the service
docker run -d -p 127.0.0.1:9027:9027 \
ghcr.io/vmosoti/rusticdoc:0.1.0
# Fill the sample invoice and convert it
curl http://localhost:9027/v1/render \
-F template=@invoice-template.docx \
-F "data=<invoice.json" \
-F steps=convert -o invoice.pdf