Thank you for downloading wger Workout Manager. wger (ˈvɛɡɐ) is a free, open source web application that manages your exercises and personal workouts, weight and diet plans. It can also be used as a simple gym management utility, providing different administrative roles (trainer, manager, etc.). It offers a REST API as well, for easy integration with other projects and tools.
It is written with python/django and uses jQuery and some D3js for charts.
For more details and a live system, refer to the project's site: https://wger.de/
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 locally
in your code repository in the docs folder (make html to compile, then open
_build/index.html).
Please consult the commands' help for further information and available parameters.
Useful to just try it out:
docker run -ti --name wger.apache --publish 8000:80 wger/apache
Then just open http://localhost:8000 and log in as: admin, password admin
Note: You can safely install from master, it is almost always in a usable and stable state.
- Install the necessary packages
$ sudo apt-get install python3-dev python-virtualenv nodejs nodejs-legacy npm libjpeg8-dev zlib1g-dev git
On fedora 23
$ sudo dnf install python3-devel python-virtualenv nodejs npm libjpeg-turbo-devel zlib-devel git
Then install the python packages from pypi in the virtualenv:
$ virtualenv --python python3 venv-django $ source venv-django/bin/activate
- Start the application. This will download the required JS and CSS libraries and create a SQlite database and populate it with data on the first run.
$ git clone https://github.com/wger-project/wger.git
$ cd wger
$ pip install -r requirements.txt # or requirements_devel.txt to develop
$ invoke create_settings \
--settings-path /home/wger/wger/settings.py \
--database-path /home/wger/wger/database.sqlite
$ invoke bootstrap_wger \
--settings-path /home/wger/wger/settings.py \
--no-start-server
$ python manage.py runserver
- Log in as: admin, password admin
After the first run you can just use django's development server. You will probably want to move the settings and sqlite files to your git folder, see the comments in the documentation (development chapter) about this:
$ python manage.py runserver
Alternatively, there are docker images for development as well, wger/devel
and wger/devel-fedora. Both images contain an instance of the application
running with django's development server using a sqlite database and can be
used to quickly setup a development instance (vim and tmux are already
installed). The only difference is that devel has an ubuntu base image while
devel-fedora uses fedora.
$ docker run -ti --name wger.devel --publish 8000:8000 wger/devel
Then, within the docker image, activate the virtualenv
$ source ~/venv/bin/activate
and start the development server
$ python manage.py runserver 0.0.0.0:8000
Then just open http://localhost:8000 and log in as: admin, password admin
- Install the necessary packages and their dependencies in a virtualenv
$ sudo apt-get install python3-dev python-virtualenv nodejs nodejs-legacy npm libjpeg8-dev zlib1g-dev $ virtualenv venv-django $ source venv-django/bin/activate $ pip install wger
- Start the application. This will download the required JS and CSS libraries and create a SQlite database and populate it with data on the first run.
$ wger bootstrap_wger
- Log in as: admin, password admin
The available options for the wger command (if installed from PyPI) or
invoke (if installed from source) are the following (use e.g. wger
<command>:
bootstrap_wger Performs all steps necessary to bootstrap the application config_location Returns the default location for the settings file and the data folder create_or_reset_admin Creates an admin user or resets the password for an existing one create_settings Creates a local settings file load_fixtures Loads all fixtures migrate_db Run all database migrations start_wger Start the application using django's built in webserver
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.
- twitter: https://twitter.com/wger_de
- mailing list: https://groups.google.com/group/wger / [email protected], no registration needed
- IRC: channel #wger on freenode.net, webchat: http://webchat.freenode.net/?channels=wger
- issue tracker: https://github.com/wger-project/wger/issues
All the code and the content is freely available:
- Main repository: https://github.com/wger-project/wger
- Mirror: https://bitbucket.org/rolandgeider/wger
The application is licenced 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 where taken from Wikipedia, see the SOURCES file in their respective folders for more details.