Skip to content

adding running locally documentation #7

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.

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

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

adding running locally documentation #7

wants to merge 1 commit into from

Conversation

phummelen
Copy link
Owner

Gents,

I added a new section to the documentation.for the option to work with containers localy.

@@ -0,0 +1,20 @@
# Docker
We are running the application within containers. Using Docker (or podman).
Information about using Docker is widly spread on the internet. We only have some basic information mentioned here.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

widly --> widely

1. To start: `docker-compose up -d` (or `docker-compose start` if just stopped)
2. To enter the container (initialize): `docker exec -it olm-web /bin/bash`
3. To load dummy data (initialize): `php artisan migrate:fresh --seed`
4. Log out or the container using (after initialisation) `ctrl-d` or `exit`
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

initialisation --> initialization

With those two pre-requisites you can start the containers locally.
Be aware, for some features you need `keys`, which are not *free to use* from the community. If needed, reach out to the core team for help.

After first startup, we have to do some manual actions. In the future we gonna try to get these steps within setup-containers.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

gonna --> going to


If you want to run the environment locally, that's possible!
You have to download the main repo(s) where a `docker-compose` file is in.
Also you have to have *Docker* (or podman) installed on you machine.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

you --> your


NB: If you have initialized the database, you can skip the *initialize* steps. Step one is mandatory.

You should see the basic site now. Several function will work, several will not work.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

function --> functions

Copy link
Collaborator

@FredMark FredMark left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I reviewed them,
Hard to tell if everything is okay,
I guess i will find out when i really start to use the manual to set it up myself (not tonight though, too late already),
I added some 'typos'-review, which are not that important, so i will chose 'approve' (submit feedback and approve)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants