Repository files navigation

A modern way for nonprofits to manage project activities and indicator results.
Try out Activity using our hosted version athikaya.io.

This is the source code that runs theActivity application. If you want to use Activity then you don't need to run this code, we offer a hosted version of the app atactivity.hikaya.app.

If you'd like to run your own copy of Activity or contribute to its development, then this is the place for you.

• Git
• Docker
• Python 3.7+, preferably inside a Python virtual environment (virtualenv,pipenv or others)
• Make sure your dependencies are up-to-date. Update depdendencies with

sudo apt-get update&& sudo apt-get -y upgrade# Linuxbrew update&& brew upgrade# Mac

For the sake of similarity between developers environments and the deployment environments, westrongly recommend using Docker. For more details, see the Dockerinstallation guide.

git clone --branch develop https://github.com/hikaya-io/activity.git&&cd activity

cp settings/local-sample.py settings/local.py

docker compose up -d

This will:

1. Pull needed Docker images
2. Launch PostgreSQL
3. Build and launch Activity
4. Run database migrations on the PostgreSQL instance

It may take a while, but Activity should be accessible athttp://localhost:8080

This setup is using the environment variables defined in the file.env.docker-compose.You can read more about Activity's expected environments variables in ourinstallation guide.

1. Apply theDjango fixtures defined in thefixtures folder:

   docker composeexec app python manage.py loaddata fixtures/auth_groups.json# Add authorization groupsdocker composeexec app python manage.py loaddata fixtures/countries.json# Add countriesdocker composeexec app python manage.py loaddata fixtures/sectors.json# Add sectors

2. Create a Django superuser/admin

   docker composeexec app python manage.py createsuperuser

   You can now use it to login athttp://localhost:8000/admin

3. Signup with a new user on Activity. Activate it through Django Admin Dashboard onhttp://localhost:8000/admin/workflow/activityuser/

You can now set up your favourite reverse proxy and link a domain to expose the app to the public.

You can use any cloud hosting provider of your choice.We have used Digital Ocean and used App services to easily deploy the app. Here is the setup documentmention on Digital Ocean forDjango app. The Digital Ocean Basic plan of 512 MB RAM | 1 vCPU will suffice. Possible option for database config for the app: 1 GB RAM / 1vCPU / 10 GB Disk / Primary only / PostgreSQL 15.

If you want setup from a droplet here are the steps you can follow to set up deployment and hosting:

1. Create anaccount on Digital Ocean.

2. Create adroplet. You can select a the Basic Ubuntu plan with at least 4GB RAM as Docker requires at least 4GB RAM droplet. RAM requirement can potentially be reduced by using Dockerhub.

3. Add your SSH key as you create your droplet. This is required to access the server later.

4. Once the droplet is created add yourdomain and DNS information.

5. Now your droplet is ready for adding your project data. On your local machinecd into the root project folder andcopy files over to the server

   rsync -av -e"ssh -i$LINK/TO/SSH_KEY/FILE/DIRECTORY" PROJECT_FOLDER_NAME root@IP.ADDRESS:/root

6. SSH into your server to check if the files are copied correctly

   ssh -i$LINK/TO/SSH_KEY/FILE/DIRECTORY root@IP.ADDRESS

7. In your server, install docker. Here are the setup instructions forUbuntu

8. Copy the settings files

   cp settings/local-sample.py settings/local.py

9. Then build and run the project on docker

   docker compose up -d

10. You can check if containers are built correctly and running by running

    docker contain ls -a

11. Run through the 'post-installation' steps from the above section to make sure all the fixtures are in place.

12. Make sure to add theenvironment variables on Digital Ocean.

13. Your application should be ready and accessible on your domain.

Activity is built and maintained by the team atHikaya.

Feel free to checkout and learn more about:

• Ourcontribution guide
• Ourdevelopment process

We are always looking for a fresh set of 👀 who want to contribute toActivity, so if you are interested, you can reach out in ourissues board oropen a Github discussion and we'll help you get started!