Neomad is a open-source community project for nomad workers and people willing to nomadize themselves.
- Git
- Python3.5 or above
- Docker-compose
If you don't have/want to use docker, you can process to the Manual installation section.
git clone [email protected]:neomad-team/neomad.org.git neomad
cd neomad
The next steps are also simple. Choose your story:
- for lazy developers: go to lazy developer install
- for lazy testers: choose the full-docker install
- for developers who want to keep control: read the Manual installation
You may then want to create a user or to insert dummy data (
make fixtures).
make install
You're done. It's called lazy for a reason! Open your browser at http://localhost:5000/login. A user was created for you. email: [email protected], password: mypass.
Lazy you!
Next times you want to run your project, you can do the following:
make start
First of all you should create your required files: make install_files.
In the settings.py file, set the DATABASE = {…, 'host': 'db', …} to
connect the server to the database ('db' is the actual name you want as
host, it is the name of the docker link).
Then run docker-compose up and open your browser at http://localhost:5000.
You can access your python server machine with
docker-compose exec -it web(you may need it to create a user for example).The sources in your docker server are in the /app folder (
cd /app).
Are you a Python warrior willing to take full control of your environment?
View the makefile file in the install section and tweak your commands. It's been made to be easily readable.
Note that you can either have your own MongoDB or use Docker even if it's only
for running a database: docker-compose up -d db.
In the previous commands you created a file called settings.py at the root of the project. Tune your settings there.
Users must currently be created manually.
To do so, activate your virtualenv source ./venv/bin/activate and run the
following command:
make create_user [email protected] password=mypass
You can now log on http://localhost/5000/login with "[email protected]" email and "mypass" as password.
For development, you may want to create a whole set of dummy data. To do so, just run:
make fixtures