Skip to content

Conversation

@mmattel
Copy link
Contributor

@mmattel mmattel commented May 8, 2025

This PR adds a minimalistic guide to run ocis based on docker run (not compose !) - for eval only !

To have a local rendering, check out and run make -C docs docs-serve and open a browser with URL:
http://localhost:1313/ocis/guides/ocis-mini-eval/


```bash
mkdir -p $HOME/ocis/ocis-config \
mkdir -p $HOME/ocis/ocis-data
Copy link
Member

@mklos-kw mklos-kw May 9, 2025

Choose a reason for hiding this comment

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

For the minimal dev setup I use:
. for config
~/.ocis for data (default)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

There are many possibilities, as you write. For ease of handling, use a subdir named ocis in your home and put everything else in there. Then you only need to "kill" one directory for starting from scratch. Remember, it is plain minimal eval only.


```bash
docker run --rm -it \
--mount type=bind,source=$HOME/ocis/ocis-config,target=/etc/ocis \
Copy link
Member

Choose a reason for hiding this comment

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

-v $(pwd):/etc/ocis/ for dev config in current working dir

Copy link
Contributor Author

@mmattel mmattel May 9, 2025

Choose a reason for hiding this comment

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

The reason for using --mount is, that on some OS (like macOS at least in the past), do have some "challenges" using -v, due to how docker implemented stuff. With mount, this is avoided completely. Additionally, we clearly make a link between the paths used.

docker run --rm -it \
--mount type=bind,source=$HOME/ocis/ocis-config,target=/etc/ocis \
--mount type=bind,source=$HOME/ocis/ocis-data,target=/var/lib/ocis \
owncloud/ocis init
Copy link
Member

@mklos-kw mklos-kw May 9, 2025

Choose a reason for hiding this comment

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

I see insecure env var below. init also has an insecure option to skip the prompt below: init --insecure yes

Copy link
Contributor Author

@mmattel mmattel May 9, 2025

Choose a reason for hiding this comment

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

good point, fixed.

@sonarqubecloud
Copy link

Copy link
Collaborator

@kobergj kobergj left a comment

Choose a reason for hiding this comment

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

I like ❤️

@mmattel mmattel merged commit 61b48d6 into master May 14, 2025
2 checks passed
@mmattel mmattel deleted the mini_docker_run_example branch May 14, 2025 08:16
ownclouders pushed a commit that referenced this pull request May 14, 2025
[docs-only] Add a minimalistic docker run example
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants