Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Improve the documentation for running in production #7315

Open
jniles opened this issue Oct 27, 2023 · 2 comments
Open

Improve the documentation for running in production #7315

jniles opened this issue Oct 27, 2023 · 2 comments
Labels
documentation

Comments

@jniles
Copy link
Contributor

jniles commented Oct 27, 2023

The BHIMA documentation for installation is pretty good and has seen several revisions. It is found at https://docs.bhi.ma/en/for-developers/installing-bhima.html.

This documentation is mostly meant for getting developers up and running, and isn't ideal for running in production. We should add a separate set of instructions for running in production that covers:

  1. Using nginx as a proxy so that users don't have to type the :$PORT after the url in the web browser.
  2. Setting a strong SESS_SECRET variable in the .env
  3. Setting up backups using cron.

Some optional stuff we might consider adding:

  1. Setting up .my.cnf so that system administration is easier.
  2. Encouraging systemd over pm2.
jniles added a commit to jniles/bhima that referenced this issue Nov 26, 2023
@jniles
feat: add debian 12 installation script
3005835 
This commit adds an installation script to prepare, download, and set up
BHIMA from a fresh install of Debian 12.  It uses docker for for mysql
and redis and systemd for restart management.  Tested on an Intel NUC7
with a fresh install of Debian 12.

Partially addresses IMA-WorldHealth#7315.
@jniles jniles mentioned this issue Nov 26, 2023
Merged
@jmcameron
Copy link
Collaborator

@jniles Shouldn't this have been closed by your recent Debian set up PR?

@jniles
Copy link
Contributor Author

jniles commented Dec 1, 2023

I suppose it could be. I would like to keep working on these issues though. It probably won't be as relevant if I can get the server to build with docker-compose.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
documentation
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
2 participants
@jmcameron @jniles