gancio/docs/install/docker.md

---
layout: default
title: Docker
permalink: /install/docker
parent: Install
---
## Table of contents
{: .no_toc .text-delta }

1. TOC
{:toc}

## Initial setup
**You do not need to clone the full repo as we distribute gancio via npm.**  
A Dockerfile and a docker-compose.yml are the only files needed.

- __Create a directory where everything related to gancio is stored (db, images, config)__
```bash
mkdir /opt/gancio
cd /opt/gancio
```
<small>note that you can choose a different directory.</small>

## Use sqlite
<div class='code-example bg-grey-lt-100' markdown="1">
1. **Download docker-compose.yml and Dockerfile**
```bash
wget https://gancio.org/docker/Dockerfile
wget https://gancio.org/docker/sqlite/docker-compose.yml
```

1. Create an empty db and config (**this is needed**)
```
touch config.json db.sqlite
mkdir user_locale
```

1. Build docker image and launch interactive setup in one step
```
docker-compose build
docker-compose run --rm gancio gancio setup --docker --db=sqlite
```
</div>

## Use postgreSQL
<div class='code-example bg-grey-lt-100' markdown="1">

1. **Download docker-compose.yml and Dockerfile**
```bash
wget https://gancio.org/docker/Dockerfile
wget https://gancio.org/docker/postgres/docker-compose.yml
```

1. Create an empty configuration (**this is needed**)
```
touch config.json
mkdir user_locale
```

1. Build docker image and launch interactive setup in one step
```
docker-compose build
docker-compose run --rm gancio gancio setup --docker --db=postgres
```
</div>


## Start gancio

1. Run your container
```bash
docker-compose up -d
```

1. Look at logs with
```bash
docker-compose logs
```

1. [Setup nginx as a proxy](/install/nginx)

1. Point your web browser to [http://localhost:13120](http://localhost:13120) or where you specified during setup and enjoy :tada:

1. You can edit `config.json` file and restart the container on your needs, see [Configuration](/config) for more details.


## Upgrade

```bash
cd /opt/gancio
docker-compose up -d --no-deps --build
```