owncloud - GitLite

KO | EN

gitlite — search

#javascript #python #react #typescript #llm #go #deep-learning #docker #nodejs #macos #kubernetes #pytorch #ios #open-source

owncloud

(★ 64)

docker image

파일 탐색기

최종 버전 다운로드 (.zip)

- 3party_apps.conf
- cron.conf
- docker_image_owncloud.config.php
- htaccess_uploads
- nginx.conf
- nginx_ssl.conf
- owncloud_autoconfig.php
- php_uploads.ini
- phpinfo.php
- bootstrap.sh
- Makefile
- oc-install-3party-apps
- occ
.dockerignore
.gitignore
docker-compose.yml
Dockerfile
LICENSE
Makefile
README.md
Vagrantfile

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/jchaney/owncloud

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd owncloud

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Docker

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

docker-compose up

compose 설정 파일에 정의된 서비스들을 대상으로 명령을 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Make

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make-ssl-cert generate-default-snakeoil

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

make owncloud-production

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

make owncloud-mariadb-get-pw

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# docker-owncloud

[![Docker Stars](https://img.shields.io/docker/stars/jchaney/owncloud.svg)][this.project_docker_hub_url]
[![Docker Pulls](https://img.shields.io/docker/pulls/jchaney/owncloud.svg)][this.project_docker_hub_url]
[![ImageLayers Size](https://img.shields.io/imagelayers/image-size/jchaney/owncloud/latest.svg)][this.project_docker_hub_url]
[![ImageLayers Layers](https://img.shields.io/imagelayers/layers/jchaney/owncloud/latest.svg)][this.project_docker_hub_url]

**This repository is *deprecated*. Please use something else which is still maintained.**

~~Maintainer wanted. Refer to https://github.com/jchaney/owncloud/issues/62~~

Docker image for [ownCloud][].

The build instructions are tracked on [GitHub][this.project_github_url].
[Automated builds][] are hosted on [Docker Hub][this.project_docker_hub_url].

## Why using this image

* It is directly based on Debian stable. No additional image layers which blow up the total image size and might by a security risk.
* Uses [nginx][] as webserver.
* [Hardened TLS](https://github.com/BetterCrypto/Applied-Crypto-Hardening/blob/master/src/configuration/Webservers/nginx/default-hsts) configuration.
* Generates unique Diffie Hellman parameters to mitigate precomputation based attacks on common parameters. Refs: [Guide to Deploying Diffie-Hellman for TLS](https://weakdh.org/sysadmin.html).
* Local caching enabled by default (APCu).
  See https://owncloud.org/blog/making-owncloud-faster-through-caching/
* Installs the ownCloud tarball directly from https://owncloud.org/ and it [securely](https://github.com/jchaney/owncloud/pull/12) verifies the GPG signature.
* Makes installing of 3party apps easy and keeps them across updates.
* The [`occ`][occ] command can be used just by typing `docker exec -ti $owncloud_container_name occ`.
* ownCloud can only be updated by redeploying the container. No update via the web interface is possible. The ownCloud installation is fully contained in the container and not made persistent. This allows to make the ownCloud installation write protected for the Webserver and PHP which run as `www-data`.
* Automated database update on ownCloud update during the startup of a redeployed/updated container.

## Getting the image

You have two options to get the image:

1. Build it yourself with `make build`.
2. Download it via `docker pull jchaney/owncloud` ([automated build][this.project_docker_hub_url]).

## ownCloud up and running

Checkout the [Makefile][] for an example or just run `make owncloud` which will setup a ownCloud container instance (called "owncloud"). After that, just head over to [http://localhost/](http://localhost/) and give it a try. You can now create an admin account. For testing purposes you can use SQLite (but remember to use a real database in production).

## Running ownCloud in production

Setup a separate container running your database server and link it to the ownCloud container.
For running in production, you need to provide a TLS key and certificate. The
Makefile defaults to `/etc/ssl/private/ssl-cert-snakeoil.key` and
`/etc/ssl/certs/ssl-cert-snakeoil.pem`. Make sure those files exist or extend
the Makefile (you can include this Makefile and overwrite some variables in
your own Makefile).
You might also want to change variables like
`docker_owncloud_permanent_storage` to define where the persistent data will be
stored.
To generate self signed once you can run the following command:

```Shell
make-ssl-cert generate-default-snakeoil
```

To setup ownCloud with [MariaDB] as backend, just run:

```Shell
make owncloud-production
```

In the initial ownCloud setup, you need to supply the database user, password, database name and database host which you can look up via:

```Shell
make owncloud-mariadb-get-pw
```

Note that this command also shows you the MariaDB root password which you need to write down because you will not be able to access it later (after you run `make owncloud-production` again to update the containers, the passwords will be different and not match the once which are actually used).

That should be it :smile:

## Update your container and ownCloud

It is recommended to rebuild/pull this image on a regular basis and redeploy your ownCloud container(s) to get the latest security fixes.
Note that ownCloud version jumps are uploaded to the `latest` tag of this image once they are tested. You might want to watch this repository to see when this happens.

Once the ownCloud image is up-to-date, just run:

```Shell
make owncloud-production
```

to update your container. ownCloud usually requires a database update when the version of ownCloud is bumped. This process [has been automated](/misc/bootstrap.sh) for this Docker image but remember that you are still in charge of making backups/snapshots prior to updates!

## Installing 3party apps

Just write the command(s) needed to install apps in a configuration file and make sure it is present as `/owncloud/3party_apps.conf` in your container.

Checkout the [example configuration][3party_apps.conf] and the [install script][oc-install-3party-apps] for details.

## docker-compose support

You can also run this image with `docker-compose`. First you need to declare all env variables since `docker-compose` does not support (yet) default variables.

```Shell
# Where to store data and database ?
export docker_owncloud_permanent_storage="~/owncloud_data"

# SSL Certificates to use.
export docker_owncloud_ssl_cert="../certs/cloud.cert"
export docker_owncloud_ssl_key="../certs/cloud.key"

# Servername
export docker_owncloud_servername="localhost"

export docker_owncloud_http_port="80"
export docker_owncloud_https_port="443"
export docker_owncloud_in_root_path="1"

export docker_owncloud_mariadb_root_password=$(pwgen --secure 40 1)
export docker_owncloud_mariadb_user_password=$(pwgen --secure 40 1)

export image_owncloud="jchaney/owncloud"
export image_mariadb="mysql"

```

Then:

```Shell
docker-compose up
```

That's all !

## Related projects

* [official docker repository for ownCloud](https://hub.docker.com/_/owncloud/)

Uses Apache as webserver and is based on the [official Docker PHP image](https://hub.docker.com/_/php/).

* [l3iggs/owncloud](https://hub.docker.com/r/l3iggs/owncloud/)

Uses Apache as webserver and is based on a self build LAMP stack based on Arch Linux.

* [Ansible role to install and manage ownCloud instances](https://github.com/debops/ansible-owncloud)

Automation framework for setting up ownCloud on any Debian based system. This offers much
  more flexibility and is not limited to Docker. So you can setup a ownCloud
  instance in a KVM virtual machine and/or a LXC container for example.

This role is part of the [DebOps](http://debops.org/) project which allows
  you to automate all the steps mentioned above (setting up a Hypervisor host with
  support for KVM and/or LXC, setting up the virtual machine/container and
  installing Webserver/PHP/Database and finally ownCloud).

The real fun with this approach begins when you manage multiple instances
  because Ansible and this role allow you to run actions like ownCloud updates
  or enabling apps or the like on all your instances automatically.

## Maintainer

The current maintainer is [Robin `ypid` Schneider][ypid].

List of previous maintainers:

1. [Josh Chaney][jchaney]
2. [silvio][]

## Problems

* If you get "Command not found" for any of the programs used then install it (make sure you know what you are doing).

> Your distribution packages: You should find missing dependencies from the errors yourself. It's _your_ machine, you're supposed to know it.

Ref: https://bb.osmocom.org/trac/wiki/PreliminaryRequirements#Generalknowledge

## License

This project is distributed under [GNU Affero General Public License, Version 3][AGPLv3].

[ypid]: https://github.com/ypid
[silvio]: https://github.com/silvio
[jchaney]: https://github.com/jchaney

[Makefile]: /Makefile
[ownCloud]: https://owncloud.org/
[occ]: https://doc.owncloud.org/server/8.1/admin_manual/configuration_server/occ_command.html
[MariaDB]: https://mariadb.org/
[nginx]: https://en.wikipedia.org/wiki/Nginx

[3party_apps.conf]: https://github.com/jchaney/owncloud/blob/master/configs/3party_apps.conf
[oc-install-3party-apps]: https://github.com/jchaney/owncloud/blob/master/misc/oc-install-3party-apps
[AGPLv3]: https://github.com/jchaney/owncloud/blob/master/LICENSE
[this.project_docker_hub_url]: https://hub.docker.com/r/jchaney/owncloud/
[this.project_github_url]: https://github.com/jchaney/owncloud
[Automated builds]: https://docs.docker.com/docker-hub/builds/