Skip to content

Latest commit

 

History

History
119 lines (80 loc) · 4 KB

README.md

File metadata and controls

119 lines (80 loc) · 4 KB

wger

wger logo

wger (ˈvɛɡɐ) Workout Manager is a free, open source web application that helps you manage your personal workouts, weight and diet plans and can also be used as a simple gym management utility. It offers a REST API as well, for easy integration with other projects and tools.

For a live system, refer to the project's site: https://wger.de/

Screenshot

Mobile app

Get it on Google Play Get it on F-Droid

Installation

These are the basic steps to install and run the application locally on a Linux system. There are more detailed instructions, other deployment options as well as an administration guide available at https://wger.readthedocs.io or in the docs repo.

Please consult the commands' help for further information and available parameters.

Production

If you want to host your own instance, take a look at the provided docker compose file. This config will persist your database and uploaded images:

https://github.com/wger-project/docker

Demo

If you just want to try it out:

    docker run -ti --name wger.demo --publish 8000:80 wger/demo

Then just open http://localhost:8000 and log in as admin, password adminadmin

Please note that this image will overwrite your data when you pull a new version, it is only intended as an easy to setup demo

Development version

We provide a docker file that sets everything up for development (however this won't persist any data)

docker run -ti  \
    -v /path/to/your/wger/checkout:/home/wger/src \
    --name wger.dev \
    --publish 8000:8000 \ 
    wger/server

Then just open http://localhost:8000 and log in as: admin, password adminadmin

For more info, check the README in wger/extras/developemt.

Alternatively you can use the production compose file for development as well, just bind your local source code into the web container (see the docker-compose.yml file for details). You will also probably want to set `DJANGO_DEBUG to false

Local installation

If you prefer a local installation, consult the development documentation

Contact

Feel free to contact us if you found this useful or if there was something that didn't behave as you expected. We can't fix what we don't know about, so please report liberally. If you're not sure if something is a bug or not, feel free to file a bug anyway.

Sources

All the code and the content is available on github:

https://github.com/wger-project/wger

Translation

Translate the app to your language on Weblate.

translation status

License

The application is licensed under the Affero GNU General Public License 3 or later (AGPL 3+).

The initial exercise and ingredient data is licensed additionally under one of the Creative Commons licenses, see the individual exercises for more details.

The documentation is released under a CC-BY-SA: either version 4 of the License, or (at your option) any later version.

Some images were taken from Wikipedia, see the SOURCES file in their respective folders for more details.