Arama Yap Mesaj Submit
Request a Callback
+90
X
X

Select Your Currency

Turkish Lira $ US Dollar Euro
X
X

Select Your Currency

Turkish Lira $ US Dollar Euro

Contact Us

Location Halkali merkez neighborhood fatih st ozgur apt no 46 , Kucukcekmece , Istanbul , 34303 , TR

Self-Hosted Sentry: Monitor PHP, Laravel and JavaScript Errors

Deploy self-hosted Sentry on Ubuntu with realistic sizing, domain and TLS, first project, Laravel/JavaScript SDKs, source maps, retention, backup, upgrades and Kafka/ClickHouse troubleshooting.

Self-Hosted Sentry: Monitor PHP, Laravel and JavaScript Errors
What will be running at the end?

Deploy self-hosted Sentry on Ubuntu with realistic sizing, domain and TLS, first project, Laravel/JavaScript SDKs, source maps, retention, backup, upgrades and Kafka/ClickHouse troubleshooting. Every command is presented as an operational step; replace example hostnames, passwords and secrets before execution.

Architecture and requirements before installation

  • Ubuntu 24.04 LTS with sudo access and a dedicated IPv4 address
  • Docker Engine and Compose v2 where the deployment uses containers
  • A DNS A record pointing the application hostname to the server
  • NVMe capacity sized for application data, logs, temporary files and backups
  • Memory and CPU headroom based on measured concurrency rather than vendor minimums

DNS and port plan

  • 80/443 TCP: reverse proxy
  • 9000/TCP: Sentry web yalnız localhost/reverse proxy
  • 25/587 TCP çıkış: e-posta kullanılacaksa

Hands-on installation steps

1. Kaynak kontrolü
nproc
free -h
df -hT
docker --version
docker compose version
2. Swap oluşturma
sudo fallocate -l 16G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo "/swapfile none swap sw 0 0" | sudo tee -a /etc/fstab
free -h
3. Kurulum
cd /opt
sudo git clone https://github.com/getsentry/self-hosted.git sentry-self-hosted
cd sentry-self-hosted
sudo ./install.sh
sudo docker compose up -d
4. Sağlık ve log
sudo docker compose ps
curl -I http://127.0.0.1:9000/_health/
sudo docker compose logs --since 15m --tail 200 web worker relay snuba-api
5. Laravel istemci
composer require sentry/sentry-laravel
php artisan sentry:publish --dsn=HTTPS_DSN_ADRESI
php artisan sentry:test
6. JavaScript istemci
npm install @sentry/browser
export SENTRY_AUTH_TOKEN=PROJE_TOKENI
npx sentry-cli sourcemaps inject ./dist
npx sentry-cli sourcemaps upload ./dist
7. Yedek öncesi durdurma
cd /opt/sentry-self-hosted
sudo docker compose stop web worker cron ingest-consumer post-process-forwarder
sudo docker compose exec -T postgres pg_dump -U postgres -Fc postgres > sentry-postgres-$(date +%F).dump
sudo docker compose start
8. Disk inceleme
sudo docker system df
sudo du -sh /var/lib/docker/volumes/* 2>/dev/null | sort -h | tail -20
sudo docker compose exec clickhouse clickhouse-client -q "SELECT database, formatReadableSize(sum(bytes_on_disk)) FROM system.parts GROUP BY database"
9. Nginx reverse proxy
sudo apt update
sudo apt install -y nginx certbot python3-certbot-nginx
sudo tee /etc/nginx/sites-available/sentry.example.com > /dev/null <<'NGINX'
server {
    listen 80;
    listen [::]:80;
    server_name sentry.example.com;
    client_max_body_size 10G;
    proxy_read_timeout 3600;
    proxy_send_timeout 3600;
    location / {
        proxy_pass http://127.0.0.1:9000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}
NGINX
sudo ln -s /etc/nginx/sites-available/sentry.example.com /etc/nginx/sites-enabled/sentry.example.com
sudo nginx -t
sudo systemctl reload nginx
10. Let’s Encrypt SSL ve yenileme testi
sudo certbot --nginx -d sentry.example.com --redirect --agree-tos --no-eff-email -m [email protected]
sudo certbot renew --dry-run
curl -I https://sentry.example.com
openssl s_client -connect sentry.example.com:443 -servername sentry.example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates

What to know before production

Production note
Self-Hosted Sentry must be isolated behind HTTPS; databases, queues and internal APIs must not be published directly to the internet.
Production note
Pin tested image versions before production. Read release notes and take an application-consistent backup before database migrations.
Production note
A database dump alone may be incomplete. Preserve persistent files, configuration, encryption keys and the exact deployed version together.
Production note
Validate the installation with a real transaction or workload, then reboot the host and confirm automatic recovery before accepting production traffic.

Common failures and root causes

Belirti / SymptomKök neden ve çözüm / Root cause and fix
Service or container does not startInspect compose configuration, dependency health, file permissions and the first fatal log line instead of repeatedly restarting.
Domain opens but HTTPS failsCheck A/AAAA records, ports 80/443, proxy mode, certificate challenge and conflicting reverse proxies.
Application cannot reach its database or queueUse the internal service hostname, verify credentials and health checks, and keep database ports off the public interface.
Works initially but fails under loadMeasure memory peaks, disk latency, connection pools and worker concurrency; increase capacity only after identifying the bottleneck.

Post-installation validation checklist

  • All services are running and their health checks pass
  • The public hostname serves a valid HTTPS certificate
  • Only explicitly required ports are reachable
  • Administrator MFA and recovery access are configured
  • Backup checksums have been recorded
  • A restore was completed in an isolated environment
  • Logs contain no repeating critical failure
  • Services recover automatically after a host reboot

Official technical sources

Related EKA Sunucu guides

Frequently asked questions

Is this suitable for production?

Yes after secrets are replaced, public access is restricted and a complete restore test has succeeded.

Are minimum resources enough?

Minimums only prove the software can start. Size CPU, memory, IOPS and storage from representative workload measurements.

Can I use Cloudflare?

Yes. Use Full (strict) TLS and configure origin certificates, WebSockets and client IP forwarding where required.

Should upgrades be automatic?

Do not automatically apply major releases. Review migrations, back up data and retain the previous tested image.

What must be backed up?

Back up databases, uploaded files, persistent volumes, configuration, encryption keys and the deployed version together.

VPS or GPU server?

An NVMe VPS fits normal web workloads. Inference, accelerated OCR and video transcoding may require a compatible GPU.

Contact us for deployment

Deploy self-hosted Sentry on Ubuntu with realistic sizing, domain and TLS, first project, Laravel/JavaScript SDKs, source maps, retention, backup, upgrades and Kafka/ClickHouse troubleshooting.

Explore VPS plansContact us for deployment
Top