[{"_1":2,"_203":-5,"_204":-5},"loaderData",{"_3":4,"_18":19,"_26":27,"_176":177},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16,"_17":11},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","dockerRebrandTour","routes/_layout",{"_20":-5,"_21":22,"_23":22,"_24":11,"_25":22},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_28":29,"_30":-5,"_31":11,"_32":11,"_33":34,"_35":36,"_37":-5,"_38":11,"_39":40,"_93":-5,"_94":95,"_164":-5,"_165":11,"_166":22,"_167":11,"_168":11,"_169":-5,"_170":11,"_171":-5,"_172":173,"_174":96,"_175":-7},"canonicalUrl","https://hub.docker.com/r/mosswill/bond/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","mosswill","reponame","bond","cloudBuildSource","isAutobuildsAvailable","repo",{"_41":42,"_48":49,"_51":52,"_53":54,"_55":11,"_56":57,"_58":59,"_60":61,"_44":36,"_33":34,"_63":64,"_65":-5,"_66":67,"_68":69,"_70":71,"_72":-5,"_73":67,"_74":75,"_76":11,"_77":34,"_78":79,"_84":11,"_85":86,"_90":34,"_91":92},"categories",[43],{"_44":45,"_46":47},"name","API management","slug","api-management","content_types",[50],"image","date_registered","2024-05-04T23:39:42.741599Z","description","Self-hostable headless QR code generator","is_private","last_updated","2026-02-05T05:57:44.76024Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[62],"application/vnd.oci.image.index.v1+json","pull_count",14314,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","

Bond

\n Self-hostable headless QR code generator\n
\n Generate QR codes with a one-endpoint API\n

\n\n## Introduction\n\nBond is a tiny, simple, and self-hostable service that enables you to generate QR codes by calling an API.\nIt was born out of a need to generate QR codes for my business when I couldn't find a fully free and secure API without limitations, along with Google shutting down their service.\nI also wanted something rudimentary without gimmicks or customization (colors, redirection, logo, shapes, etc.), hence I decided to make it myself.\n\n## Features\n\nBond has all these features implemented :\n- Generate a QR code of any size with any content\n- Simple security using a defined secret to deter bots\n- Support for HTTP and HTTPS\n- Support for standalone / proxy deployment\n\nOn top of these, one may appreciate the following characteristics :\n- Written in Go\n- Holds in a single file with few dependencies\n- Holds in a ~14 MB compressed Docker image\n\nFor more information, read about [Configuration](#configuration) and [API Reference](#api-reference).\n\n## Deployment and Examples\n\n### Deploy with Docker\n\nYou can run Bond with Docker on the command line very quickly.\n\nYou can use the following commands :\n\n```sh\n# Create a .env file\ntouch .env\n\n# Edit .env file ...\n\n# Option 1 : Run Bond attached to the terminal (useful for debugging)\ndocker run --env-file .env -p mosswill/bond\n\n# Option 2 : Run Bond as a daemon\ndocker run -d --env-file .env -p mosswill/bond\n```\n\n### Deploy with Docker Compose\n\nTo help you get started quickly, multiple example `docker-compose` files are located in the [\"examples/\"](examples) directory.\n\nHere's a description of every example :\n\n- `docker-compose.simple.yml`: Run Bond as a front-facing service on port 80., with environment variables supplied in the `docker-compose` file directly.\n\n- `docker-compose.volume.yml`: Run Bond as a front-facing service on port 80, with environment variables supplied as a `.env` file mounted as a volume.\n\n- `docker-compose.ssl.yml`: Run Bond as a front-facing service on port 443, listening for HTTPS requests, with certificate and private key provided as mounted volumes.\n\n- `docker-compose.proxy.yml`: A full setup with Bond running on port 80, behind a proxy listening on port 443, and Gotenberg running as well while not being exposed to external requests.\n\nWhen your `docker-compose` file is on point, you can use the following commands :\n```sh\n# Run Bond in the current terminal (useful for debugging)\ndocker-compose up\n\n# Run Bond in a detached terminal (most common)\ndocker-compose up -d\n\n# Show the logs written by Bond (useful for debugging)\ndocker logs \n```\n\n### Deploy as a standalone application\n\nDeploying Bond as a standalone application assumes the following prerequisites :\n- You have Go installed on your server\n- You have properly filled your `.env` file\n- Your DNS and networking configuration is on point\n\nWhen all the prerequisites are met, you can run the following commands in your terminal :\n\n```sh\n# Retrieve the code\ngit clone https://github.com/will-moss/bond\ncd bond\n\n# Create a new .env file\ncp sample.env .env\n\n# Edit .env file ...\n\n# Build the code into an executable\ngo build -o bond main.go\n\n# Option 1 : Run Bond in the current terminal\n./bond\n\n# Option 2 : Run Bond as a background process\n./bond &\n\n# Option 3 : Run Bond using screen\nscreen -S bond\n./bond\n \n```\n\n## Configuration\n\nTo run Bond, you will need to set the following environment variables in a `.env` file located next to your executable :\n\n> **Note :** Regular environment variables provided on the commandline work too\n\n| Parameter | Type | Description | Default |\n| :---------------------- | :-------- | :------------------------- | ------- |\n| `SSL` | `boolean` | Whether HTTPS should be used in place of HTTP. When configured, Bond will look for `certificate.pem` and `key.pem` next to the executable for configuring SSL. Note that if Bond is behind a proxy that already handles SSL, this should be set to `false`. | False |\n| `PORT` | `integer` | The port Bond listens on. | 80 |\n| `SECRET` | `string` | The secret used to secure your Bond instance against bots / malicious usage. (This parameter can be left empty to disable security) | a-very-long-and-complicated-secret |\n| `MAX_SIZE` | `integer` | The max size for your QR codes, in pixels, such that a QR code can never be greater than MAX_SIZE x MAX_SIZE pixels. | 1024 |\n| `RECOVERY_LEVEL` | `string` | The recovery level used to generate the QR codes. One of : Low, Medium, High, and Highest (case-insensitive). | Medium |\n| `ENABLE_LOGS` | `boolean` | Whether all the HTTP requests should be displayed in the console / logs. | TRUE |\n\n> **Note :** Boolean values are case-insensitive, and can be represented via \"ON\" / \"OFF\" / \"TRUE\" / \"FALSE\" / 0 / 1.\n\n> **Tip :** You can generate a random secret with the following command :\n\n```sh\nhead -c 1024 /dev/urandom | base64 | tr -cd \"[:lower:][:upper:][:digit:]\" | head -c 32\n```\n\n## API Reference\n\nBond exposes the following API, consisting of a single endpoint :\n\n#### Generate a QR code\n\n```\n GET /\n```\n\n| Parameter | Type | Description |\n| :-------- | :------- | :-------------------------------- |\n| `secret` | `string` | **Required.** Your server secret (can be empty if your `SECRET` setting is empty). |\n| `size` | `string` | **Required.** The size (in pixels) of the QR code to generate. (The QR code will be size x size pixels.) |\n| `content` | `string` | **Required.** The data to encode in the QR code. |\n\nThe API will directly return the image representing the QR code generated using your settings.\n\n## Usage\n\nTo generate QR codes using Bond, you can copy and adapt the following examples :\n\n### curl\n\n```sh\ncurl -o qr-code.png \"https://bond.your-domain.tld/?content=YOUR-CONTENT&size=512&secret=YOUR-SECRET\"\n```\n\n### wget\n\n```sh\nwget -O qr-code.png \"https://bond.your-domain.tld/?content=YOUR-CONTENT&size=512&secret=YOUR-SECRET\"\n```\n\n### Javascript\n\n```javascript\nasync function to_qrcode(text) {\n const url = `https://bond.your-domain.tld/?` + new URLSearchParams({\n size: 512,\n content: text,\n secret: 'YOUR-SECRET'\n });\n let response = await fetch(url);\n\n if (response.status !== 200) {\n console.log('HTTP-Error: ' + response.status);\n return null;\n }\n\n const blob = await response.blob();\n const objectURL = URL.createObjectURL(blob);\n\n const image = document.createElement('img');\n image.src = objectURL;\n\n const container = document.getElementById('YOUR-CONTAINER');\n container.append(image);\n}\n\nawait to_qrcode(\"YOUR-CONTENT\");\n```\n\n## Troubleshoot\n\nShould you encounter any issue running Bond, please refer to the following common problems that may occur.\n\n> If none of these matches your case, feel free to open an issue.\n\n\n#### Bond is unreachable over HTTP / HTTPS\n\nPlease make sure that the following requirements are met :\n\n- If Bond runs as a standalone application without proxy :\n - Make sure your server / firewall accepts incoming connections on Bond's port.\n - Make sure your DNS configuration is correct. (Usually, such record should suffice : `A bond XXX.XXX.XXX.XXX` for `https://bond.your-server-tld`)\n - Make sure your `.env` file is well configured according to the [Configuration](#configuration) section.\n\n- If Bond runs behind Docker / a proxy :\n - Perform the previous (standalone) verifications first.\n - Make sure that `PORT` (Bond's port) is well set in `.env`.\n - Check your proxy forwarding rules.\n\nIn any case, the crucial part is [Configuration](#configuration).\n\n#### Bond returns an error 4xx instead of a QR code\n\nPlease make sure that :\n- You're using the `GET` HTTP method.\n- You've included the `secret` parameter, and the value of it equals the value of the `SECRET` defined in your `.env`.\n- The `size` you requested fits within the range 1 <= `size` <= `MAX_SIZE`.\n\n\n#### Something else\n\nPlease feel free to open an issue, explaining what happens, and describing your environment.\n\n## Credits\n\nHey hey ! It's always a good idea to say thank you and mention the people and projects that help us move forward.\n\nBig thanks to the individuals / teams behind these projects :\n- [go-qrcode](https://github.com/skip2/go-qrcode) : For the QR code generation.\n- [go-chi](https://github.com/go-chi/chi) : For the web server.\n- The countless others!\n\nAnd don't forget to mention Bond if you like it or if it helps you in any way!\n","has_starred","hub_user","immutable_tags_settings",{"_80":11,"_81":82},"enabled","rules",[83],".*","is_automated","permissions",{"_87":22,"_88":11,"_89":11},"read","write","admin","user","storage_size",122556172,"orgData","recentTags",[96],{"_97":50,"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_56":152,"_153":99,"_154":34,"_155":62,"_44":156,"_157":158,"_159":160,"_161":152,"_162":71,"_163":22},"content_type","creator",24097822,"digest","sha256:94d6abf31949ab2dd47b86940719e5a48efe57e03aeb6d4b46569dace41a20f9","full_size",5858196,"id",657781096,"images",[108,125,130,137,143,147],{"_109":110,"_100":111,"_112":113,"_114":115,"_116":117,"_118":119,"_120":113,"_121":-5,"_122":123,"_68":71,"_124":-5},"architecture","amd64","sha256:8a170547673561e443a5f325cd1da86919b10b2417a49cbb80fc844050923c93","features","","last_pulled","2026-10-21T01:00:55.329456026Z","last_pushed","2026-02-05T05:57:39.64898102Z","os","linux","os_features","os_version","size",6204964,"variant",{"_109":126,"_100":127,"_112":113,"_114":128,"_116":129,"_118":119,"_120":113,"_121":-5,"_122":103,"_68":71,"_124":-5},"arm64","sha256:203e738aa7d86c9ca0c60d543dc8bf2d9245aa27dea78a2ac6675da1eabb2493","2026-10-18T23:48:02.169885886Z","2026-02-05T05:57:37.36419741Z",{"_109":131,"_100":132,"_112":113,"_114":133,"_116":134,"_118":119,"_120":113,"_121":-5,"_122":135,"_68":71,"_124":136},"arm","sha256:1562819ddbfa29913c7ab22fb99fa6e2623b669ec3b6a856f939d367f2f2c0ae","2026-10-18T23:48:02.151860756Z","2026-02-05T05:57:38.460360558Z",5935974,"v7",{"_109":138,"_100":139,"_112":113,"_114":140,"_116":141,"_118":138,"_120":113,"_121":-5,"_122":142,"_68":71,"_124":-5},"unknown","sha256:3149f383fe2587a0937457f34889b36a8c93575f7d5c4eb666a68ae651536e8e","2026-10-18T23:48:02.19529503Z","2026-02-05T05:57:41.550104236Z",1348,{"_109":138,"_100":144,"_112":113,"_114":145,"_116":146,"_118":138,"_120":113,"_121":-5,"_122":142,"_68":71,"_124":-5},"sha256:818e6ba9b53a058ec532a270d49012d44ea91814732ced4f5c08adf6df2fa483","2026-10-19T18:44:04.091810411Z","2026-02-05T05:57:40.707503516Z",{"_109":138,"_100":148,"_112":113,"_114":149,"_116":150,"_118":138,"_120":113,"_121":-5,"_122":151,"_68":71,"_124":-5},"sha256:46a4bd3e9eb73eb28891c664c6d472059196f9832276d5bf0bf7e5ee70cb7cc9","2026-10-18T23:48:02.298309179Z","2026-02-05T05:57:42.283740964Z",1354,"2026-02-05T05:57:43.398742Z","last_updater","last_updater_username","media_type","latest","repository",24016185,"tag_last_pulled","2026-10-21T02:00:10.491858001Z","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxRunInCloud","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_39":178,"_186":187,"_172":201,"_202":11},{"_41":179,"_48":181,"_51":52,"_53":54,"_55":11,"_56":57,"_58":59,"_60":182,"_44":36,"_33":34,"_63":64,"_65":-5,"_66":67,"_68":69,"_70":71,"_72":-5,"_73":67,"_74":75,"_76":11,"_77":34,"_78":183,"_84":11,"_85":185,"_90":34,"_91":92},[180],{"_44":45,"_46":47},[50],[62],{"_80":11,"_81":184},[83],{"_87":22,"_88":11,"_89":11},"tags",{"_188":69,"_189":-5,"_190":-5,"_191":192},"count","next","previous","results",[193],{"_97":50,"_98":99,"_100":101,"_102":103,"_104":105,"_106":194,"_56":152,"_153":99,"_154":34,"_155":62,"_44":156,"_157":158,"_159":160,"_161":152,"_162":71,"_163":22},[195,196,197,198,199,200],{"_109":110,"_100":111,"_112":113,"_114":115,"_116":117,"_118":119,"_120":113,"_121":-5,"_122":123,"_68":71,"_124":-5},{"_109":126,"_100":127,"_112":113,"_114":128,"_116":129,"_118":119,"_120":113,"_121":-5,"_122":103,"_68":71,"_124":-5},{"_109":131,"_100":132,"_112":113,"_114":133,"_116":134,"_118":119,"_120":113,"_121":-5,"_122":135,"_68":71,"_124":136},{"_109":138,"_100":139,"_112":113,"_114":140,"_116":141,"_118":138,"_120":113,"_121":-5,"_122":142,"_68":71,"_124":-5},{"_109":138,"_100":144,"_112":113,"_114":145,"_116":146,"_118":138,"_120":113,"_121":-5,"_122":142,"_68":71,"_124":-5},{"_109":138,"_100":148,"_112":113,"_114":149,"_116":150,"_118":138,"_120":113,"_121":-5,"_122":151,"_68":71,"_124":-5},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
8a1705476735	linux/amd64	5.92 MB
1562819ddbfa	linux/arm/v7	5.66 MB
203e738aa7d8	linux/arm64	5.59 MB

mosswill/bond

Tags for mosswill/bond