barge/README.md

78 lines
2.4 KiB
Markdown
Raw Normal View History

2018-08-10 14:30:25 +02:00
[![banner](doc/img/repo-banner@2x.png)](https://oceanprotocol.com)
<h1 align="center">docker-images</h1>
2018-08-15 17:30:06 +02:00
> 💧 Ocean Protocol & Docker
2018-08-10 14:30:25 +02:00
> [oceanprotocol.com](https://oceanprotocol.com)
2018-08-15 17:30:06 +02:00
Docker compose and tools running the complete Ocean Protocol stack
2018-08-10 14:30:25 +02:00
## Table of Contents
- [Get Started](#get-started)
- [Docker](#docker)
- [Contributing](#contributing)
- [License](#license)
---
## Get Started
2018-08-13 15:12:21 +02:00
For local development you can use Docker & Docker Compose. To do that you need to have the newest versions available of both:
* [Docker](https://www.docker.com/get-started)
* [Docker Compose](https://docs.docker.com/compose/)
2018-08-10 14:30:25 +02:00
### Docker
The most simple way to get started is with Docker compose:
```bash
2018-08-13 11:22:36 +02:00
docker-compose --project-name=ocean up
2018-08-10 14:30:25 +02:00
```
2018-08-13 15:12:21 +02:00
This will give you a local instance of Ocean Protocol.
After having everything running, you could open the browser and access to the **pleuston frontend** application:
```
http://localhost:3000
```
## Ocean components
The Ocean Docker compose starts the following components:
* **Pleuston** frontend application. Listening the **3000** port.
* **Provider backend**. Listening the **5000** port.
* **Keeper contracts**. Listening the **8545** port.
* **BigchainDB**. Listening the **9984** port.
![Ocean Docker Images](doc/img/docker-images.jpg)
2018-08-10 14:30:25 +02:00
## Contributing
We use GitHub as a means for maintaining and tracking issues and source code development.
If you would like to contribute, please fork this repository, do work in a feature branch, and finally open a pull request for maintainers to review your changes.
Ocean Protocol uses [C4 Standard process](https://github.com/unprotocols/rfc/blob/master/1/README.md) to manage changes in the source code. Find here more details about [Ocean C4 OEP](https://github.com/oceanprotocol/OEPs/tree/master/1).
## License
```
Copyright 2018 Ocean Protocol Foundation
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```