Step 1
Log into the panel
You sign in with a username and password. On first login you use the initial ones, then change the password right away.
codev qr images · free tool
Upload a photo, get a link and its QR code.
Perfect for catalogs, menus, displays and product sheets: upload an image and instantly get a public link and a printable QR code. Customers scan it and see it. Free.
Free · install it yourself (with Docker or on your web hosting) or we'll set it up for you, ready to use.
100% free
JPG, PNG and WEBP photos
No account
how to use it
Three steps, and the image is online with its QR.
Here's what you see once it's installed. Click any screen to enlarge it.
Step 2
Upload the image
Pick a photo (JPG, PNG or WEBP): the upload starts and you see the preview instantly.
Step 3
Link and QR ready
For every image you get the public link and the QR code: copy them, open them or print them.
two ways to get it
On your computer or on your site. Your call.
You can try it right away on your computer with Docker, or publish it on your web hosting. It takes very little.
Your computer (Windows, Mac or Linux)
An internet connection (the first time)
An up-to-date browser
For the computer method: Docker Desktop
For the site method: web hosting with PHP and a database
The project: qrcode-uploader-source.zip
On your computer
with Docker · to try it- Perfect for trying it right away, risk-free
- Docker sets everything up by itself: nothing to configure by hand
- Nothing changes on your computer
- Starts with a single command
On your site
web hosting · to really use it- You publish it on your domain, reachable anywhere
- Needs web hosting with PHP and a database
- Use it from any device
- Set up from a single configuration file
step-by-step installation
The guide, step by step.
Two paths. Pick a method and open the steps: you'll find commands and plain-language explanations.
The simplest way to try it on your computer: Docker sets everything up by itself, you don't have to install anything by hand. You only need Docker Desktop and the project file.
01Install Docker Desktop
Download Docker Desktop from the official site and install it. Then open it and wait for "Docker is running" to appear.
# Official Docker site
https://www.docker.com/products/docker-desktop/
02Open the project .zip file
Extract qrcode-uploader-source.zip into a folder on your computer. Inside you'll find these files:
admin.php
docker-compose.yml
Dockerfile
start.sh
config.php
If you see them, you're in the right folder.
03Open the terminal in the folder
The terminal is the little window where you type a command.
Mac: right-click inside the folder → "New Terminal at Folder".
Windows: click the path bar at the top, type cmd and press Enter.
04Start the project
Type this command and press Enter. The first time, Docker takes a few minutes to set everything up.
docker compose up --build
The scrolling lines are normal: it means it's working.
05Open the panel in the browser
When it's done, open the browser and go to this address:
http://localhost:8080/admin.php
localhost means "your computer".
06Do the first login
Log in with the initial credentials and change the password right away.
Username: admin
Password: password
07Upload the first image
From the panel, upload a photo in JPG, PNG or WEBP format. The tool instantly creates the public link and the QR code.
08How to shut it down
If the terminal is still open, press CTRL + C. To stop everything:
docker compose down
To publish it on a real domain you need PHP and a MySQL database: most web hosting already has them. If any step feels tricky, we'll do it for you.
Check that your web hosting has: PHP 7.4 or later, a MySQL/MariaDB database and access to phpMyAdmin (the panel to manage the database).
01Upload the files to the server
Open your web hosting's file manager (or an FTP program like FileZilla) and copy all the project files into the site's public folder:
public_html # the most common
www # on some hosting
httpdocs # on others
Check that these are there: admin.php, config.php, functions.php, view.php.
02Create the database
From your web hosting panel create a new MySQL database and note the 4 access details:
Database address (host)
Database name
Username
Password
03Import the database file
Open phpMyAdmin, choose the database, click Import, select the db/qrcode_uploader.sql file included in the .zip and click Go.
This creates the storage for users, images and QR codes.
04Enter your details in config.php
Open config.php and put in your database and domain details:
$DB_NAME = 'database_name';
$DB_USER = 'database_user';
$DB_PASS = 'database_password';
$BASE_URL = 'https://yourdomain.com';
In
$BASE_URL don't add the trailing slash: write https://yourdomain.com, not https://yourdomain.com/.
05Allow image saving
The images folder needs to be able to receive files. Set the permissions to 755 (if that's not enough, try 775). Avoid 777: it's less secure.
06Open the panel and log in
In the browser go to https://yourdomain.com/admin.php and log in with the initial credentials:
Username: admin
Password: password
07Change the password
The initial password is only for the first login. Change it right away (the project includes a make_hash.php file that helps you create a secure one), then remove it from the server.
if something goes wrong
The most common problems, already solved.
Docker won't start
Check that Docker Desktop is open and shows "Docker is running". Then try again:
docker compose up --build
If that's not enough, restart Docker Desktop.
The localhost:8080 page won't open
Make sure you're visiting exactly http://localhost:8080/admin.php and that the terminal with docker compose up is still open. If you closed it, restart it from the project folder.
Login doesn't work
The initial credentials are admin / password. If you can't get in, check that you imported the database file db/qrcode_uploader.sql in phpMyAdmin and try again.
Images won't upload
Check in order: the file is JPG, PNG or WEBP; the images folder has 755 permissions; the details in config.php are correct; the file doesn't exceed your web hosting limit (usually 8 or 32 MB).
The QR code isn't generated
The QR code is created by an external service (api.qrserver.com): your server needs to be able to reach the internet. If you have a very strict firewall, ask your web hosting support to allow outbound requests.
"Access denied" error on the database
The access details in config.php are incorrect. Double-check the address, database name, username and password, and that the user has permissions on the database.
simple words
The technical words, explained simply.
Docker
A program that "packages" the project and runs it the same everywhere, with nothing to configure by hand.
Web hosting
The online space where your site's files live, reachable from the internet.
Database
The orderly archive where the tool saves users, images and QR codes.
PHP
The language the project is written in to run on the server.
MySQL / MariaDB
The system that manages the database. It's often already included with your web hosting.
localhost
Your computer as seen by the browser. localhost:8080 points to port 8080 on your PC.
QR code
The little square you frame with your phone camera to instantly open the image link.
Panel (dashboard)
The page where you manage the uploaded images and QR codes.
phpMyAdmin
The visual panel to manage the database without typing commands.
before going live
The final checklist.
Eight quick checks to be sure everything's in place.
The site opens in the browser
Login with username and password works
You changed the initial password
A test photo uploads
The QR code is generated after upload
The images folder can save files
The details in config.php are correct
You removed make_hash.php from the server
let's talk
Don't want to install it yourself? We'll do it.
We put it online on your domain, customize it with your logo and colors, and leave you just the fun part: uploading images and printing QR codes. We're an Italian software house: tell us what you need it for.
No commitment · we reply same day