docker-cartojw/README.md

docker-cartodb
==============

[![](https://images.microbadger.com/badges/image/sverhoeven/cartodb.svg)](https://microbadger.com/#/images/sverhoeven/cartodb "Get your own image badge on microbadger.com")
[![](https://images.microbadger.com/badges/version/sverhoeven/cartodb.svg)](https://hub.docker.com/r/sverhoeven/cartodb/)

This docker container provides a fully working cartodb development solution
without the installation hassle.

Just run the commands and then connect to http://cartodb.localhost with your you browser.

The default login is dev/pass1234. You may want to change it when you'll run
it for the outside.

It also creates an 'example' organization with owner login admin4example/pass1234.
Organization members can be created on http://cartodb.localhost/user/admin4example/organization

How to build the container:
---------------------------

```
git clone https://github.com/sverhoeven/docker-cartodb.git
docker build -t="sverhoeven/cartodb" docker-cartodb/
```

How to run the container:
-------------------------

```
docker run -d -p 3000:3000 -p 8080:8080 -p 8181:8181 sverhoeven/cartodb
```

The ports the cartodb container publishes must be combined behind a single [NGINX](http://nginx.org/) web server. 
In the GitHub repo there is an [example NGINX config file (config/cartodb.nginx.proxy.conf)](https://github.com/sverhoeven/docker-cartodb/blob/master/config/cartodb.nginx.proxy.conf), which needs to be added to /etc/nginx/conf.d/ directory, after which the web server must be restarted.
This will setup a reverse proxy for the CartoDB/imports (3000), SQL Api (8080) and Map api (8181) to default http port (80).
Alternativly use instructions at https://hub.docker.com/r/spawnthink/cartodb-nginx/ to run NGINX as a docker container with the correct config file already in it.

The CartoDB instance has been configured with the hostname `cartodb.localhost`, this means the web browser and web server need to be able to resolve `cartodb.localhost` to the machine where the web server is running.
This can be done by adding cartodb.localhost alias to your hosts file. For example
```
sudo sh -c 'echo 127.0.1.1 cartodb.localhost >> /etc/hosts'
```
(For Windows it will be `C:\Windows\System32\drivers\etc\lmhosts`)
Initial commit 2014-11-14 17:59:55 +08:00			`docker-cartodb`
			`==============`

Replace imagelayers badge with microbadger 2016-08-02 18:00:15 +08:00			`[![](https://images.microbadger.com/badges/image/sverhoeven/cartodb.svg)](https://microbadger.com/#/images/sverhoeven/cartodb "Get your own image badge on microbadger.com")`
			`[![](https://images.microbadger.com/badges/version/sverhoeven/cartodb.svg)](https://hub.docker.com/r/sverhoeven/cartodb/)`
Added badge + use same name for docker image as on docker hub. 2016-03-26 04:22:02 +08:00
Prepare for automated build. Moved config files down. 2015-07-24 18:24:28 +08:00			`This docker container provides a fully working cartodb development solution`
Populate docker-cartodb with required files. Here I commit all the required files for a development cartodb container to be successfully build and run with Docker. 2014-11-15 23:32:19 +08:00			`without the installation hassle.`

Prepare for automated build. Moved config files down. 2015-07-24 18:24:28 +08:00			`Just run the commands and then connect to http://cartodb.localhost with your you browser.`
Populate docker-cartodb with required files. Here I commit all the required files for a development cartodb container to be successfully build and run with Docker. 2014-11-15 23:32:19 +08:00
Switched to subdomainless urls. - Allow avatar to be uploaded to local fs. - Renamed star avatar - Allow uploads up to 100Mb file size 2015-07-08 22:48:20 +08:00			`The default login is dev/pass1234. You may want to change it when you'll run`
Populate docker-cartodb with required files. Here I commit all the required files for a development cartodb container to be successfully build and run with Docker. 2014-11-15 23:32:19 +08:00			`it for the outside.`

Switched to subdomainless urls. - Allow avatar to be uploaded to local fs. - Renamed star avatar - Allow uploads up to 100Mb file size 2015-07-08 22:48:20 +08:00			`It also creates an 'example' organization with owner login admin4example/pass1234.`
			`Organization members can be created on http://cartodb.localhost/user/admin4example/organization`
Create an organization. Organization can be used to share maps between members and because members uses same db an remote schema only has to be created once. A remote schema is a schema from a remote database server which can be made accessable using foreign data wrapper. 2015-02-18 16:51:25 +08:00
Populate docker-cartodb with required files. Here I commit all the required files for a development cartodb container to be successfully build and run with Docker. 2014-11-15 23:32:19 +08:00			`How to build the container:`
Switched to subdomainless urls. - Allow avatar to be uploaded to local fs. - Renamed star avatar - Allow uploads up to 100Mb file size 2015-07-08 22:48:20 +08:00			`---------------------------`
Populate docker-cartodb with required files. Here I commit all the required files for a development cartodb container to be successfully build and run with Docker. 2014-11-15 23:32:19 +08:00
			```
Prepare for automated build. Moved config files down. 2015-07-24 18:24:28 +08:00			`git clone https://github.com/sverhoeven/docker-cartodb.git`
Added badge + use same name for docker image as on docker hub. 2016-03-26 04:22:02 +08:00			`docker build -t="sverhoeven/cartodb" docker-cartodb/`
Populate docker-cartodb with required files. Here I commit all the required files for a development cartodb container to be successfully build and run with Docker. 2014-11-15 23:32:19 +08:00			```

			`How to run the container:`
Switched to subdomainless urls. - Allow avatar to be uploaded to local fs. - Renamed star avatar - Allow uploads up to 100Mb file size 2015-07-08 22:48:20 +08:00			`-------------------------`
Populate docker-cartodb with required files. Here I commit all the required files for a development cartodb container to be successfully build and run with Docker. 2014-11-15 23:32:19 +08:00
			```
Added badge + use same name for docker image as on docker hub. 2016-03-26 04:22:02 +08:00			`docker run -d -p 3000:3000 -p 8080:8080 -p 8181:8181 sverhoeven/cartodb`
Populate docker-cartodb with required files. Here I commit all the required files for a development cartodb container to be successfully build and run with Docker. 2014-11-15 23:32:19 +08:00			```

Better NGINX + hostname docs 2016-09-27 23:49:53 +08:00			`The ports the cartodb container publishes must be combined behind a single [NGINX](http://nginx.org/) web server.`
			`In the GitHub repo there is an [example NGINX config file (config/cartodb.nginx.proxy.conf)](https://github.com/sverhoeven/docker-cartodb/blob/master/config/cartodb.nginx.proxy.conf), which needs to be added to /etc/nginx/conf.d/ directory, after which the web server must be restarted.`
			`This will setup a reverse proxy for the CartoDB/imports (3000), SQL Api (8080) and Map api (8181) to default http port (80).`
			`Alternativly use instructions at https://hub.docker.com/r/spawnthink/cartodb-nginx/ to run NGINX as a docker container with the correct config file already in it.`
Put cartodb db services behind nginx. Updated configs to master branch of Cartodb repos. 2015-05-16 19:01:49 +08:00
Better NGINX + hostname docs 2016-09-27 23:49:53 +08:00			The CartoDB instance has been configured with the hostname `cartodb.localhost`, this means the web browser and web server need to be able to resolve `cartodb.localhost` to the machine where the web server is running.
			`This can be done by adding cartodb.localhost alias to your hosts file. For example`
Switched to subdomainless urls. - Allow avatar to be uploaded to local fs. - Renamed star avatar - Allow uploads up to 100Mb file size 2015-07-08 22:48:20 +08:00			```
			`sudo sh -c 'echo 127.0.1.1 cartodb.localhost >> /etc/hosts'`
			```
Better NGINX + hostname docs 2016-09-27 23:49:53 +08:00			(For Windows it will be `C:\Windows\System32\drivers\etc\lmhosts`)