Install OpenRepair in your shop
Two commands: clone and run. No file editing, paid services or registration: your instance runs on your own server.
Requirements
- ·Docker and Docker Compose (Docker Desktop on Mac/Windows, the docker package on Linux).
- ·git to clone the repository (or download the ZIP from GitHub).
- ·Nothing else: Flask and MariaDB run inside the containers. You don't install Python or a database yourself.
Two commands
- 01
Clone the repository
Download the code from GitHub and enter the folder. That's all you need: docker-compose.yml already defines the web app and database.
git clone https://github.com/robertocarrascoso/OpenRepair - 02
Start the containers
Docker builds the image, starts Flask and MariaDB, and serves the app. No file editing: .env is optional for local testing.
docker compose up -d
Open http://localhost:8000 and sign in with admin@openrepair.com / admin123. This password is public: change it in the dashboard as soon as you sign in, or set your admin credentials in .env before the first launch. The database starts empty; add your own records from the dashboard.
Environment variables
The .env file is optional: every variable has a default and the app starts without it. For production, copy the template and change the passwords and session key before exposing the app to the internet.
cp .env.example .env| Variable | Default value | Description |
|---|---|---|
| PORT | 8000 | Public web port. |
| DB_NAME | openrepair | Database name. |
| DB_USER | openrepair_user | MariaDB user. |
| DB_PASSWORD | cambia-esta-contrasena | Database user password. |
| DB_ROOT_PASSWORD | cambia-esta-root | MariaDB root password. |
| SECRET_KEY | cambia-esta-clave | Flask session key. Generate a random one (see below). |
| ADMIN_EMAIL | admin@openrepair.com | Admin created on first launch (if no users exist). |
| ADMIN_PASSWORD | admin123 | Initial admin password. Change it before exposing the app. |
Generate your SECRET_KEY
The Flask session key must be random and secret. Generate one with Python:
python -c "import secrets; print(secrets.token_hex(32))"Copy the result into SECRET_KEY in your .env file.
Ready to get started.
Clone the repository and start your shop with docker compose up. No file editing.