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"
Plus, manage docker containers with Portainer.
Note: Fedora 37, 39 and alpine linux x86-64 compatible, could not try sles IBM Z s390x, rhel IBM Z s390x and raspberrypi.
- 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).
Create rules to open ports to the internet, or to a specific IPv4 address or range.
- http: 80
- https: 443
- portainer: 9001
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
Make sure you have the latest versions of Docker and Docker Compose installed on your machine.
Clone this repository or copy the files from this repository into a new folder.
Make sure to add your user to the docker group.
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 | |
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.
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.
docker compose -f portainer-docker-compose.yml -p portainer up -d
manage docker with Portainer 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.
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
Copy all files into a new directory:
docker compose up -d # Starts services in detached mode (in the background)
https://docs.docker.com/reference/cli/docker/compose/
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
Run Claude Code with environment variables inline:
https://docs.ollama.com/integrations/claude-code
Now you can pull a model: docker exec -it ollama ollama pull qwen3.5
More models can be found on the https://ollama.com/library.
https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html
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/