https://github.com/damalis/full-stack-proxy-nginx-claude-code-for-everyone-with-docker-compose
If You want to install Claude Code at short time; install full stack proxy nginx Claude Code with Docker Compose, manage Claude Code docker containers with Portainer, and even secure your site with SSL.
https://github.com/damalis/full-stack-proxy-nginx-claude-code-for-everyone-with-docker-compose
ai anthropic anthropic-ai anthropic-claude claude claude-code claude-code-ui claudecode cloudcli cloudcliui ollama
Last synced: 2 days ago
JSON representation
If You want to install Claude Code at short time; install full stack proxy nginx Claude Code with Docker Compose, manage Claude Code docker containers with Portainer, and even secure your site with SSL.
- Host: GitHub
- URL: https://github.com/damalis/full-stack-proxy-nginx-claude-code-for-everyone-with-docker-compose
- Owner: damalis
- Created: 2026-04-12T14:52:07.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-06T08:54:00.000Z (3 months ago)
- Last Synced: 2026-05-06T10:41:36.292Z (3 months ago)
- Topics: ai, anthropic, anthropic-ai, anthropic-claude, claude, claude-code, claude-code-ui, claudecode, cloudcli, cloudcliui, ollama
- Language: Shell
- Homepage:
- Size: 90.8 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# [full stack proxy nginx Claude Code for everyone with docker compose](https://github.com/damalis/full-stack-proxy-nginx-claude-code-for-everyone-with-docker-compose)
If You want to install Claude Code at short time;
"Use free on web Claude Code with Ollama and CloudCLI UI"\
"free on mobile and web with CloudCLI (aka Claude Code UI)"\
"Install on either a localhost or a remote server"
#### Full stack Proxy Nginx Claude Code:
[](https://claude.com/product/claude-code)
[](https://ollama.com/)
[](https://www.docker.com/)
[](https://nginx.com/)
[](https://certbot.eff.org/)
[](https://letsencrypt.org/)
[](https://www.portainer.io/?hsLang=en)
[](https://docs.docker.com/compose/)
[](https://www.gnu.org/software/bash/)
Plus, manage docker containers with Portainer.
#### Supported CPU architectures:
#### Supported Linux Package Manage Systems:
#### Supported Linux Operation Systems:
[](https://alpinelinux.org/)
[](https://fedoraproject.org/)
[](https://www.centos.org/)
[](https://www.debian.org/)
[](https://www.ubuntu.com/)
[](https://www.redhat.com/en/technologies/linux-platforms/enterprise-linux)
[](https://www.opensuse.org/)
[](https://archlinux.org/)
[](https://www.raspberrypi.com/)
##### Note: Fedora 37, 39 and alpine linux x86-64 compatible, could not try sles IBM Z s390x, rhel IBM Z s390x and raspberrypi.
##### After installing the repository, a system reboot is required on Red Hat OS, Arch Linux.
##### System Requirements
- Operating System: Current 64-bit Linux operating system.
- Processor: 8-core 64-bit processor (Intel i5/AMD Ryzen 3 or better recommended).
- RAM: Minimum 16GB (32GB recommended for larger models).
- Storage: At least 20GB free disk space (models like Llama 3.2 require significant space).
- GPU (Optional): NVIDIA GPU with 4GB+ VRAM for hardware acceleration (CUDA support required).
#### With this project you can quickly run the following:
- [Claude Code](https://github.com/anthropics/claude-code)
- [Ollama](https://hub.docker.com/r/ollama/ollama)
- [proxy (nginx)](https://hub.docker.com/_/nginx)
- [certbot (letsencrypt)](https://hub.docker.com/r/certbot/certbot)
#### For certbot (letsencrypt) certificate:
- [Set DNS configuration of your domain name](https://support.google.com/a/answer/48090?hl=en)
#### IPv4/IPv6 Firewall
Create rules to open ports to the internet, or to a specific IPv4 address or range.
- http: 80
- https: 443
- portainer: 9001
#### Contents:
- [Auto Configuration and Installation](#automatic)
- [Manual Configuration and Installation](#manual)
- [Requirements](#requirements)
- [Configuration](#configuration)
- [Installation](#installation)
- [Usage](#usage)
- [Website](#website)
- [Claude Code](#claude-code)
- [Ollama](#ollama)
- [Proxy](#proxy)
### Automatic
#### Exec install shell script for auto installation and configuration
download with
```
git clone https://github.com/damalis/full-stack-proxy-nginx-claude-code-for-everyone-with-docker-compose.git
```
Open a terminal and `cd` to the folder in which `docker-compose.yml` is saved and run:
```
cd full-stack-proxy-nginx-claude-code-for-everyone-with-docker-compose
chmod +x install.sh
LC_ALL=C.UTF-8 ./install.sh # LC_ALL=C.UTF-8 if not os language english
```
### Manual
#### Requirements
Make sure you have the latest versions of **Docker** and **Docker Compose** installed on your machine.
- [How install docker](https://docs.docker.com/engine/install/)
- [How install docker compose](https://docs.docker.com/compose/install/)
Clone this repository or copy the files from this repository into a new folder.
Make sure to [add your user to the `docker` group](https://docs.docker.com/install/linux/linux-postinstall/#manage-docker-as-a-non-root-user).
#### Configuration
download with
```
git clone https://github.com/damalis/full-stack-proxy-nginx-claude-code-for-everyone-with-docker-compose.git
```
Open a terminal and `cd` to the folder in which `docker-compose.yml` is saved and run:
```
cd full-stack-proxy-nginx-claude-code-for-everyone-with-docker-compose
```
Copy the example environment into `.env`
```
cp env.example .env
```
Edit the `.env` file to change values of
|```LOCAL_TIMEZONE```|```DOMAIN_NAME```|```DIRECTORY_PATH```|```LETSENCRYPT_EMAIL```|```SSL_SNIPPET```|```ANTHROPIC_API_KEY```|
Variable
Value
LOCAL_TIMEZONE
to see local timezones
DIRECTORY_PATH
pwd at command line
SSL_SNIPPET
localhost
echo 'Generated Self-signed SSL Certificate at localhost'
remotehost
certbot certonly --webroot --webroot-path /tmp/acme-challenge --rsa-key-size 4096 --non-interactive --agree-tos --no-eff-email --force-renewal --email ${LETSENCRYPT_EMAIL} -d claude.${DOMAIN_NAME}
ANTHROPIC_API_KEY
free
leave it blank
other
Get API Key
#### Installation
Firstly: will create external volume
```
docker volume create --driver local --opt type=none --opt device=${PWD}/certbot --opt o=bind certbot-etc
```
Localhost ssl: Generate Self-signed SSL Certificate with guide [mkcert repository](https://github.com/FiloSottile/mkcert).
```
docker compose up -d
```
then reloading for proxy ssl configuration
```
docker container restart proxy
```
The containers are now built and running. You should be able to access the claude code installation with the configured IP in the browser address. `https://claude.DOMAIN_NAME`.
For convenience you may add a new entry into your hosts file.
### Portainer
```
docker compose -f portainer-docker-compose.yml -p portainer up -d
```
manage docker with [Portainer](https://www.portainer.io/) is the definitive container management tool for Docker, Docker Swarm with it's highly intuitive GUI and API.
You can also visit `https://claude.DOMAIN_NAME:9001` to access portainer after starting the containers.
### Usage
#### You could manage docker containers without command line with portainer.
#### Here’s a quick reference of commonly used Docker Compose commands
```
docker ps -a # Lists all containers managed by the compose file
```
```
docker compose start # Starts previously stopped containers
```
```
docker compose stop # Stops all running containers
```
```
docker compose down # Stops and removes containers, networks, etc.
```
```
docker compose down -v # Add --volumes to remove volumes explicitly
```
```
docker rm -f $(docker ps -a -q) # Removes portainer and the other containers
```
```
docker volume rm $(docker volume ls -q) # Removes all volumes
```
```
docker network prune # Remove all unused networks
```
```
docker system prune # Removes unused data (containers, networks, images, and optionally volumes)
```
```
docker system prune -a # Removes all unused images, not just dangling ones
```
```
docker rmi $(docker image ls -q) # Removes portainer and the other images
```
```
docker container logs container_name_or_id # Shows logs from all services
```
#### Project from existing source
Copy all files into a new directory:
```
docker compose up -d # Starts services in detached mode (in the background)
```
#### Docker run reference
[https://docs.docker.com/reference/cli/docker/compose/](https://docs.docker.com/reference/cli/docker/compose/)
#### Website
You should see the "CloudCLI UI installation" page in your browser. If not, please check if your CloudCLI UI installation satisfies requirements.
```
https://claude.DOMAIN_NAME
```
[open source overview and settings](https://cloudcli.ai/docs/open-source-self-hosting/open-source-overview)
#### Claude Code
Run Claude Code with environment variables inline:
[https://docs.ollama.com/integrations/claude-code](https://docs.ollama.com/integrations/claude-code)
#### Ollama
Now you can pull a model: ```docker exec -it ollama ollama pull qwen3.5```
[Recommended Models](https://docs.ollama.com/integrations/claude-code#recommended-models).
More models can be found on the [https://ollama.com/library](https://ollama.com/library).
##### Installing the NVIDIA Container Toolkit
[https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html)
#### Proxy
Proxying is typically used to distribute the load among several servers, seamlessly show content from different websites, or pass requests for processing to application servers over protocols other than HTTP.
add or remove code in the ```./proxy/templates/proxy.conf.template``` file for custom proxy configurations
[https://docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/](https://docs.nginx.com/nginx/admin-guide/web-server/reverse-proxy/)