Access
- URL:
https://<SERVER_IP> - Protected with HTTP Basic Authentication
- Credentials stored in:
/root/.adclaw-credentials - View them with:
cat /root/.adclaw-credentials
First Steps
- Open the URL in your browser
- Accept the self-signed SSL warning
- Enter the username and password from the credentials file
- You will be redirected to the AdClaw interface
Important Files and Directories
- Install directory:
/opt/adclaw - Docker Compose:
/opt/adclaw/docker-compose.yml - Environment file:
/opt/adclaw/.env - Data volume:
/var/lib/docker/volumes/adclaw-data/_data - Secret volume:
/var/lib/docker/volumes/adclaw-secret/_data - Nginx config:
/etc/nginx/sites-available/adclaw.conf - Auth file:
/etc/nginx/auth/.htpasswd-adclaw - SSL certificates:
/etc/nginx/ssl/ - Credentials:
/root/.adclaw-credentials
Management Commands
Start:
docker compose -f /opt/adclaw/docker-compose.yml up -d
Stop:
docker compose -f /opt/adclaw/docker-compose.yml down
Restart:
docker compose -f /opt/adclaw/docker-compose.yml restart
View logs:
docker logs -f adclaw
Configuration
Web UI can be used to control and update the configuration.
Or manually edit environment variables inside /opt/adclaw/.env and apply changes:
docker compose -f /opt/adclaw/docker-compose.yml up -d
Enabling SSL with a Domain
1. Point your domain to the server IP.
2. Edit Nginx config and replace both server_name <IP>; with your domain (<your-domain>) for both HTTP (port 80) and HTTPS (port 443) blocks:
vim /etc/nginx/sites-available/adclaw.conf
3. Install Certbot:
apt install -y certbot python3-certbot-nginx
4. Run the following command to generate a valid Let's Encrypt certificate:
certbot certonly --nginx --non-interactive --agree-tos --email youremail@example.com -d yourdomain.com
5. Replace SSL paths in Nginx config:
vim /etc/nginx/sites-available/adclaw.conf
# Before:
# ssl_certificate /etc/nginx/ssl/fullchain.pem;
# ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# After:
# ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
# ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
6. Restart Nginx to apply the changes:
systemctl restart nginx
7. Open your browser and visit: https://yourdomain.com
