.. _geonode:

=====================
GeoNode Basic Install
=====================

This is the most basic installation of GeoNode. It won't use an external server like ``Apache Tomcat``, ``PostgreSQL`` or ``HTTPD``.

First of all, we need to prepare a new Python Virtual Environment

Since GeoNode needs a large number of different python libraries and packages, it's recommended to use a python virtual environment to avoid conflicts on dependencies with system-wide python packages and other installed software. Also, every time see the documentation on the `Virtualenvwrapper <https://virtualenvwrapper.readthedocs.io/en/stable/>`_ package for more information

.. note:: The GeoNode Virtual Environment must only be created the first time. You won't need to create it again every time.

.. code-block:: shell

  which python3.10  # copy the path of the python executable

  mkdir -p ~/.virtualenvs
  python3.10 -m venv ~/.virtualenvs/geonode4
  source ~/.virtualenvs/geonode4/bin/activate


At this point your command prompt shows a ``(geonode4)`` prefix, this indicates that your virtualenv is active.

.. note:: The next time you need to access the Virtual Environment just run:

  .. code-block:: shell

    source /usr/share/virtualenvwrapper/virtualenvwrapper.sh
    workon geonode4

    # Alterantively you can also create the virtual env like below
    source ~/.virtualenvs/geonode4/bin/activate

.. note:: In order to save permanently the virtualenvwrapper environment run:

  .. code-block:: shell

    vim ~/.bashrc

    # Write the following lines at the bottom of the file
    export WORKON_HOME=~/.virtualenvs
    source /usr/share/virtualenvwrapper/virtualenvwrapper.sh

.. code-block:: shell

  # Let's create the GeoNode core base folder and clone it
  sudo mkdir -p /opt/geonode4/; sudo usermod -a -G www-data $USER; sudo chown -Rf $USER:www-data /opt/geonode4/; sudo chmod -Rf 775 /opt/geonode4/

  # Clone the GeoNode source code on /opt/geonode
  cd /opt; git clone https://github.com/GeoNode/geonode.git -b 4.4.x geonode4

.. code-block:: shell

  # Install the Python packages
  cd /opt/geonode4
  pip install -r requirements.txt
  pip install -e . --upgrade
  pip install pygdal=="`gdal-config --version`.*"

Initialize GeoNode

.. code-block:: shell

  # Initialize GeoNode
  sudo chmod +x *.sh
  sudo chmod -Rf 777 geonode/static_root/ geonode/uploaded/

Update the Database references

.. code-block:: shell

  # Edit the GeoNode environment variables
  vim .env_local

    GEONODE_DATABASE=geonode --> GEONODE_DATABASE=geonode4
    GEONODE_GEODATABASE=geonode_data --> GEONODE_GEODATABASE=geonode4_data
    DATABASE_URL=...alhost:5432/geonode --> DATABASE_URL=...alhost:5432/geonode4
    GEODATABASE_URL=...alhost:5432/geonode_data --> GEODATABASE_URL=...alhost:5432/geonode4_data

.. code-block:: shell

  # Run the migration scripts
  ./paver_local.sh sync