Compare commits
1 Commits
1.2
...
bb8e7f359f
| Author | SHA1 | Date | |
|---|---|---|---|
| bb8e7f359f |
30
README.md
30
README.md
@@ -7,33 +7,21 @@ A program to take notes during a sermon. The web app was built with PHP and Sym
|
|||||||
This was my first publicly available docker container so I did not realize what some decisions would do. If you are upgrading from v1 you first need to save your database OR you will lose all your current notes!! Follow the steps below to do that
|
This was my first publicly available docker container so I did not realize what some decisions would do. If you are upgrading from v1 you first need to save your database OR you will lose all your current notes!! Follow the steps below to do that
|
||||||
|
|
||||||
1. You need to make sure that you have a running SSH server on your host computer
|
1. You need to make sure that you have a running SSH server on your host computer
|
||||||
2. Make a directory in your `sermon-notes` folder for your database (e.g. `data`)
|
2. On your host computer, `docker exec -it sermon-notes bash`
|
||||||
3. On your host computer, `docker exec -it sermon-notes bash`
|
3. `cd var/`
|
||||||
4. `scp .env {user}@{IP}:{path}`
|
4. `scp data.db {user}@{host computer IP}:{path}`
|
||||||
5. Authenticate with the password
|
5. Authenticate with the password
|
||||||
6. `cd var/`
|
6. This will copy the file over SFTP to the host computer
|
||||||
7. `scp data.db {user}@{IP}:{path}/data`
|
7. After this then you run the `docker run...` command in Step 1 of the `Installation` instructions below, once the container is running you need to copy the `data.db` file into the working directory of the docker container.
|
||||||
8. This will copy the file to the host computer
|
- For example, if you have `~/docker/sermon-notes` as the path for the container on the host computer, you'll copy the `data.db` to `~/docker/sermon-notes/data`
|
||||||
9. After this then you run the `docker run...` command in Step 3 of the `Installation` instructions below
|
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
1. Make a directory in your desired docker storage folder (e.g. `~/docker/sermon-notes`), then `cd` into it.
|
1. Make a directory in your desired docker storage folder (e.g. `~/docker/sermon-notes`), then `cd` into it.
|
||||||
2. Create a file called `.env` in that folder, no need to add anything to it right now.
|
2. Create a file called `.env` in that folder, no need to add anything to it right now.
|
||||||
3. Download your preferred compose file (`wget -O compose.yml {link}`)
|
3. Run `docker run -d --name sermon-notes -p 80:80 -v $PWD/data:/data -v $PWD/.env:/var/www/html/.env gitea.rkprather.com/ryan/sermon-notes:latest`, this will download and start the container and keep it running in the background. If you already have something on port 80 change the first `80` to whatever open port you'd like.
|
||||||
1. [`compose.sqlite.yml`](https://gitea.rkprather.com/ryan/sermon-notes/raw/branch/main/docker/compose.sqlite.yml) - compose file for if you are planning to use SQLite
|
4. Run `docker exec -it sermon-notes bash install.sh` This will run an install script to create an .env file specific to your install, populate with the beginning factors, and then run a `composer` command to download the necessary package dependancies.
|
||||||
2. [`compose.mysql.yml`](https://gitea.rkprather.com/ryan/sermon-notes/raw/branch/main/docker/compose.mysql.yml) - compose file with an integrated MYSQL database image
|
5. Once complete you have a running system that you can navigate to in your browser with `http://{ip}:{port}`|`http://{hostname}:{port}`. Then you just need to register for an account. The first account that is created is made an admin so that you can access the `Reference Editor` and update any reference material if necessary.
|
||||||
3. [`compose.mariadb.yml`](https://gitea.rkprather.com/ryan/sermon-notes/raw/branch/main/docker/compose.mariadb.yml) - compose file with an integrate MariaDB database image
|
|
||||||
4. [`compose.pgsql.yml`](https://gitea.rkprather.com/ryan/sermon-notes/raw/branch/main/docker/compose.pgsql.yml) - compose file with an integrate Postgres database image
|
|
||||||
5. [`compose.shared-db.yml`](https://gitea.rkprather.com/ryan/sermon-notes/raw/branch/main/docker/compose.shared-db.yml) - compose file with no database image because you are planning on using an existing database container or bare metal server
|
|
||||||
4. Pull the image `docker pull gitea.rkprather.com/ryan/sermon-notes:latest`
|
|
||||||
5. **NOTE: IF UPGRADING SKIP THIS STEP!!!** - Run the setup script, this will setup your .env file so that when you start the container everything will be where it is supposed to be.
|
|
||||||
- `docker run --rm -it -v ${PWD}/.env:/var/www/html/.env gitea.rkprather.com/ryan/sermon-notes:latest /var/www/html/setup.php --{database-type} {--shared}`
|
|
||||||
- `{database-type}` = `sqlite`, `mysql`, `mariadb`, or `pgsql`
|
|
||||||
- If you intend on this being connected to a shared database make sure that you specify `--shared`.
|
|
||||||
6. Start the container with compose `docker compose up -d`
|
|
||||||
7. **NOTE: IF UPGRADING SKIP THIS STEP!!!** Run `docker exec -it sermon-notes /var/www/html/install.php`. This will run the `php composer` to populate the database with all the desired reference material.
|
|
||||||
8. Once complete you have a running system that you can navigate to in your browser with `http://{ip}:{port}`|`http://{hostname}:{port}`. Then you just need to register for an account. The first account that is created is made an admin so that you can access the `Reference Editor` and update any reference material if necessary.
|
|
||||||
|
|
||||||
## Operation
|
## Operation
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user