theis.gaedigk
5875a51e94
- Inserted 5 storage locations including Main Freezer, Kitchen Freezer, Pantry, Kitchen Fridge, and Cellar Shelf. - Added approximately 100 products with details such as name, description, price, amount, storage location, expiry date, bottling date, and picture. - Included both self-frozen items and store-bought items, with appropriate attributes for each.
StockHome
The problem solver for every home in the world: STOCKHOME! Have you ever spent too long searching for things in your freezer or pantry? If so, this open-source project is just the right thing for your home server!
Features
- Organize your food at home
- Keep track of the Expiry and Bottling date of your food
- Organzize your food and products into different storages (Storage locations)
- Rename your app and change the currency
- Keep track of the stored amount of your food
- Keep track of the costs for your food
Installation
1. Install Docker
If you haven't installed Docker yet, install it by running as root:
curl -sSL https://get.docker.com | sh
exit
2. Clone repository
If you haven't installed git, download the source code from this repository from the release page and unpack the .zip file.
OR
If you want to be always up to date, you can clone this repository by running:
git clone https://git.the1s.de/theis.gaedigk/stockhome.git
Note
: To do this, you must have git installed. How to install git?
3. Run Stockhome
First, navigate into the root directory of this repository and run:
docker compose up -d --build
The database and all necessary services are started and initialised automatically.
4. First login
The default admin credentials are always:
Username: admin
Password: admin
Keep in mind that you should change the password later in the settings page.
Development
Prerequisites
- Docker
- Visual Studio Code
- Cloned the repository
Start backend and database
First, navigate into the root directory of this repository and run:
docker compose -f docker-compose.dev.yml up -d --build
Start frontend
Navigate into the frontend directory and run:
npm install
npm run dev
The frontend is now running on http://localhost:5173 and the backend is running on http://localhost:8004.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Whole project made by Theis Gaedigk!