umap/docs
John Martinez 89cfa7d93d Ran through the 'Ubuntu from Scratch' procedure using a fresh Ubuntu 22.04.3 LTS VM and took notes on what worked and what didn't.
Here's a summary of the changes and why

* added 'apt update' before the install -- only _needed_ on a completely fresh VM, but never hurts

* added an install of the virtualenv package, because it is used later but: do you still need it AND python3-venv? I'm assuming it was done that way for a reason.

* changed indentation on the mkdir so it will format correctly

* added `-D ~postgres` to the commands executed as postgres user because the postgres user does not, by default, have permission to read into real user's home directories (at least in 22.04) and so the commands would error out

* change `source <activate>` to `. activate` because the line `sudo -u umap -i` launches `sh`, not `bash`, and `sh` does not recognize the source command. `.` works in either.

* remove the instructions to change STATIC_ROOT and MEDIA_ROOT because they are already defaulted to those values in the current version sample of local.py

* added a notice to change the SECREY_KEY and ADMINS list just because it seemed like a good idea.

Side note: I have not seen any docs anywhere that explains exactly what the secret Key does, or where it is used. It's used a magic variable in the config file.. ?

I am not currently messing with nginx or wsgi, so I can't comment on those parts.
2023-09-19 18:32:13 +00:00
..
administration.md Improve documentation (#746) 2020-02-26 21:31:39 +01:00
changelog.md changelog 2023-09-18 11:27:17 +02:00
contributing.md From to setup.cfg+setuptools to pyproject.toml+hatch 2023-06-17 09:09:36 -04:00
custom.md Allow to customize user display name and URL slug 2023-06-16 14:59:59 +02:00
docker.md Update docs/docker.md 2023-06-29 15:26:34 +02:00
index.md add Windows install info 2020-04-26 09:34:04 -06:00
install.md Quick doc about how to upgrade 2023-06-23 18:44:06 +02:00
install_windows.md add note on developing 2020-04-28 11:28:48 -06:00
requirements.txt Use magiclink extension for changelog with links 2023-08-23 09:45:44 -04:00
settings.md Allow to configure default share and edit status 2023-08-07 08:16:49 +02:00
ubuntu.md Ran through the 'Ubuntu from Scratch' procedure using a fresh Ubuntu 22.04.3 LTS VM and took notes on what worked and what didn't. 2023-09-19 18:32:13 +00:00