# Docker Images Reference {#docker-images-reference}


All official Ever Gauzy Docker images and their usage.


## Published Images {#published-images}


| Image                               | Description        | Size   |
| ----------------------------------- | ------------------ | ------ |
| `ghcr.io/ever-co/gauzy-api`         | API server         | ~800MB |
| `ghcr.io/ever-co/gauzy-webapp`      | Angular web app    | ~200MB |
| `ghcr.io/ever-co/gauzy-api-demo`    | Demo API instance  | ~800MB |
| `ghcr.io/ever-co/gauzy-webapp-demo` | Demo webapp        | ~200MB |
| `ghcr.io/ever-co/gauzy-desktop-api` | Desktop server API | ~1GB   |


## Tags {#tags}


| Tag           | Description              |
| ------------- | ------------------------ |
| `latest`      | Latest stable release    |
| `develop`     | Latest development build |
| `vX.Y.Z`      | Specific version         |
| `sha-xxxxxxx` | Specific commit          |


## Basic Usage {#basic-usage}



### API Server {#api-server}


```bash
docker run -d \
  --name gauzy-api \
  -p 3000:3000 \
  -e DB_TYPE=sqlite \
  -e JWT_SECRET=your-secret \
  ghcr.io/ever-co/gauzy-api:latest
```


### Web App {#web-app}


```bash
docker run -d \
  --name gauzy-webapp \
  -p 4200:4200 \
  -e API_BASE_URL=http://localhost:3000 \
  ghcr.io/ever-co/gauzy-webapp:latest
```


## Docker Compose {#docker-compose}


```yaml
services:
  api:
    image: ghcr.io/ever-co/gauzy-api:latest
    ports:
      - "3000:3000"
    env_file: .env

  webapp:
    image: ghcr.io/ever-co/gauzy-webapp:latest
    ports:
      - "4200:4200"
```


## Building Custom Images {#building-custom-images}


```bash
docker build -t custom-gauzy-api -f .deploy/api/Dockerfile .
```


## Related Pages {#related-pages}


- [Production Deployment](https://sourcey-gauzy.pages.dev/devops/production-deployment/index.md) — deployment
- [Docker Troubleshooting](https://sourcey-gauzy.pages.dev/troubleshooting/docker-issues/index.md) — issues
- [Docker Swarm](https://sourcey-gauzy.pages.dev/deployment/docker/docker-swarm/index.md) — swarm mode