qr-forge is a self-hosted QR code generator that supports WiFi connections. Whether you want to create a QR code for your WiFi network or share information easily, qr-forge has you covered. It features a FastAPI backend, the option to run locally with Docker, and a user-friendly dark interface.
Follow these steps to download and run qr-forge easily:
-
Visit the Releases page.
-
On the Releases page, you will see the latest version of qr-forge listed. Look for the files provided for download.
-
Choose the correct file for your operating system:
- For Docker users:
- Download the Docker image for easy setup.
- For Local setup (without Docker):
- Download the Debian package if running on a Debian-based system.
- For Docker users:
-
Once the download completes, follow the steps below for installation and running the software.
-
Operating System:
- Debian or any Debian-based Linux distribution for the Debian package.
- Docker installed if using the Docker image.
-
Memory:
- Minimum 1 GB RAM recommended.
-
Disk Space:
- At least 500 MB of free space for the installation.
-
Open your terminal.
-
If you haven’t installed Docker yet, follow the official Docker documentation for installation instructions.
-
Pull the qr-forge Docker image using the command:
docker pull ghost19-95/qr-forge -
Once downloaded, run the Docker container:
docker run -d -p 8000:80 ghost19-95/qr-forge -
Open your web browser and go to
http://localhost:8000to access qr-forge.
-
After downloading the Debian package, open your terminal.
-
Navigate to the directory where the package was downloaded. You can use the
cdcommand, e.g.:cd ~/Downloads -
Install the package using the command:
sudo dpkg -i qr-forge-*.deb -
If there are dependency issues, resolve them by running:
sudo apt-get install -f -
After the installation, you can start qr-forge by running:
qr-forge -
Open your web browser and go to
http://localhost:8000to access qr-forge.
- Open your web browser and go to
http://localhost:8000. - Select the type of QR code you want to generate.
- Enter the required information, such as your WiFi credentials if you are generating a WiFi QR code.
- Click on the "Generate" button.
- Your QR code will appear on the screen. You can download it or print it as needed.
- WiFi Support: Generate QR codes that allow users to connect to your WiFi effortlessly.
- FastAPI Backend: Enjoy fast and responsive performance.
- Dark UI: A modern interface that is easy on the eyes.
- Self-Hosted: You control your data and the accessibility of the application.
Yes, qr-forge can be installed directly on Debian systems without Docker.
Since qr-forge is self-hosted, your data stays with you. Ensure you keep your installation updated.
Yes! Feel free to fork the repository and submit your changes via pull requests.
For any issues or feedback, please reach out by opening an issue in this repository. We appreciate your contributions and suggestions.
- Documentation: Check our Wiki for detailed guides.
- Community: Join the discussions and connect with other users in our Discussion page.
Don’t forget to visit this page to download qr-forge and start generating QR codes today!