Skip to content

Home Information - Your home, your data, organized.

Python
3.5 KB
Raw Blame
Home Information Logo

Dependencies

Notes and help for project dependencies.

Provided for convenience. May be outdated.

Python

Needed for running and for local development.

MacOS

Get python 3.11 package and install from: https://www.python.org/downloads/

Ubuntu (GNU/Linux)

 sudo apt update && sudo apt upgrade
 sudo add-apt-repository ppa:deadsnakes/ppa
 sudo apt-get update
 apt list | grep python3.11
 sudo apt-get install python3.11
 sudo apt install python3.11-venv

Docker

For running, optional for local development.

MacOS

See: https://docs.docker.com/desktop/setup/install/mac-install/

Ubuntu (GNU/Linux)

sudo apt-get update
sudo apt-get remove docker docker-engine docker.io
sudo apt install docker.io
sudo apt install docker-compose
sudo systemctl start docker

GitHub - SSH Key Setup

For local development only.

MacOS and Ubuntu (GNU/Linux)

It is a better security practice, but not required, to generate an SSH key dedicated for GitHub use. If you do not have an SSH key already generated, or want to generate one for GitHub use, then use one of these, replacing with your email:

ssh-keygen -t ed25519 -C "[email protected]" -f ~/.ssh/github_key

# or just
ssh-keygen -t ed25519 -C "[email protected]"

Then on GitHub:

  • go to your profile settings (click your profile picture, then "Settings");
  • click "SSH and GPG keys";
  • click "New SSH key" (or "Add SSH key");
  • give the key a descriptive name (e.g., "My Laptop"),
  • type is "Authentication Key" (the default);
  • paste your public key into the key field. (e..g, ~/.ssh/github_key.pub or ~/.ssh/id_e25519.pub); and then
  • finish by clicking the "Add SSH Key" button.

If you decided to use a dedicated GitHub key (i.e., not the default key), it is also recommeneded (but not required) to add this section to ~/.ssh/config:

Host github.com
    IdentityFile ~/.ssh/github_key
    PreferredAuthentications publickey

You can test if this is set up and working properly from your local command line with:

ssh -T [email protected]

If it is working, you should see a message like:

Hi <yourname>! You've successfully authenticated, but GitHub does not provide shell access.

Redis

For local development only.

MacOS

Download tarball from: https://redis.io/download.

brew install redis

# Yields these executables:
/usr/local/bin/redis-server 
/usr/local/bin/redis-cli 

mkdir ~/.redis
touch ~/.redis/redis.conf

Then run with redis-server.

Ubuntu (GNU/Linux)

cd ~/Downloads
tar zxvf redis-6.2.1.tar.gz
cd redis-6.2.1
make test
make

sudo cp src/redis-server /usr/local/bin
sudo cp src/redis-cli /usr/local/bin

mkdir ~/.redis
touch ~/.redis/redis.conf

Then run with redis-server.

Poppler

Optional. Required for PDF thumbnail previews on file attributes. Without it, PDF attributes still upload and work — they just display a generic icon instead of a rendered preview.

The pdf2image Python package (installed via requirements) shells out to pdftoppm from the poppler-utils system package. Docker builds install this automatically; local development needs it installed separately.

MacOS

brew install poppler

Ubuntu (GNU/Linux)

sudo apt install poppler-utils